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Section 1 


INTRODUCTION 


The TEKTRONIX 4112 Computer Display Terminal 
(Figure 1-1) is a graphics and alphanumerics terminal. 
The terminal’s features are briefly described in this 


section and discussed in detail in subsequent sections 
of this manual. 


ABOUT THIS MANUAL 


This is the 4112 Computer Display Terminal Operator's 
Manual. It explains in detail the features and capabili- 
ties of the terminal from the operator's point of view. 


Before reading this manual, you should read “Introduc- 
ing Your 4112.” This short brochure provides initial 
information and examples to help you use the 4112. 


RELATED DOCUMENTATION 


Additional documentation is included in the following 
manuals: 


@® 4112 Computer Display Terminal Host Program- 
mer’s Manual 


@ 4110 Series Command Reference Manual 


@ 4112 Computer Display Terminal Service Manual 
Volumes 1 and 2 (Optional) 


SOFTWARE SUPPORT 


The new features of the 4112 don’t make your existing 
4010-series applications programs obsolete. 


The 4112 is compatible with 4010-style graphics. In 
most cases, a program written and executed ona 
4010-family Tektronix terminal can be executed on 
your 4112 with few if any changes. The only 
modifications necessary are those which take advan- 
tage of features that are new to the 4112. These 
include the dialog area (see Section 2), new features of 
graphics input (GIN) mode (see Section 4), and such 
graphics features as segments, panels and gray-index 
levels. 


4112 OPERATOR'S 


The 4112 can be driven by TEKTRONIX PLOT 10 
software products: 


® Interactive Graphics Library 
@ Terminal Control System (and associated packages) 
@ Easy Graphing 


See the user's manuals for those products for informa- 
tion on how to generate graphics output. 


If you choose to write your own software to drive the 
terminal, see the Host Programmer's Manual and the 
4110 Series Command Reference Manual for important 
information. 
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INTRODUCTION 


ABOUT THE 4112 


The rest of this section briefly introduces the 4112’s 
major features. References are made to sections in this 
manual where the features are discussed in detail. 


SELF DIAGNOSTICS 


Every time you turn the terminal on, it tests certain 
parts of its circuitry. If there is a problem which would 
prevent use of the terminal or one of its options, a light 
pattern flashes on the indicator lamps on the keyboard. 
In Some cases an error message is also displayed on 
the screen. 


You can record this light pattern and report it to a 
service technician. This makes it much easier and 
faster for the service person to correct the difficulty. 


See Appendix B and the discussion of the “Power Up 
Sequence” and ‘Self Test’ in Section 2 for details. 


THE GRAPHICS AREA 


Pictures (graphics) and text are displayed on the 15- 
inch screen (Figure 1-2). The brightness of the display 
ig controlled by the INTENSITY control knob. 


Segments 


A “graphics segment” is a picture or a part of a picture 
which can be manipulated by terminal commands. 


The 4112 stores segments locally, allowing a graphics 
application program to be more flexible and allowing a 
greater interaction with the terminal operator. Local 
storage of segments also reduces terminal/host com- 
munications needs and allows the terminal to handle 
some of the computational and storage tasks for which 
the host would otherwise be responsible. 


Multiple Viewports 


The screen can be divided into as many as 64 
individual viewports. Creating viewports is normally 
done by a host resident software progam. See the 4112 
Host Programmer's Reference Manual for details. The 
segments in the viewports can be manipulated locally 
by using the viewing keys. 
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Graphics Input 


Graphics input (GIN) mode allows you to send graphics 
information to a host resident program, either from the 
terminal, a plotter, or a graphics tablet. GIN mode 
functions in much the same way on a 4112 as it does 
on a 4010-family terminal, but with some added 
features. See Section 4 for details. 


THE VIEWING KEYS 


The 4112's four viewing keys allow you to manipulate 
segments by: 


@ putting the terminal into Framing mode so you can 
“zoom” in on a segment for a closer view 


® putting the terminal into Framing mode so you can 
“pan” across a segment to view part of it in greater 
detail 


e@ restoring the original view 


@ restoring the original aspect ratio for the viewport (if 
you changed it by zooming and panning) 


® getting an overview of the entire viewport (after you 
have zoomed or panned for a close-up of part of it) 


@ creating a border around a viewport 


There is also a key which allows you to select the 
viewport in which the viewing keys are active. 


The viewing keys are described in detail in Section 2. 


DIALOG AREA 


The dialog area is a part of the terminal's memory that 
stores non-graphics text which is the dialog between 
the terminal operator and the host or the terminal itself. 
The dialog may be invisible, entirely visible or a part of 
the dialog area may be visible. 


In most programs, text sent to and received from the 
host is dialog between the terminal operator and the 
application program or host monitor. You can define 
any portion of the screen as the area in which all such 
dialog appears. This keeps it from becoming mixed in 
with vectors and text which are intended as part of the 
graphics output. 
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INDICATOR LIGHTS 


FUNCTION KEYS 
COMMAND KEYS 


FRAMING KEYS 


COMMAND KEYS <I 


TYPEWRITER-LIKE THUMBWHEELS 


KEYS 
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Figure 1-2. 4112 Display and Keyboard. 
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SETUP MODE 


There are many English-like commands (called “setup 
commands”) which can be entered directly from the 
keyboard. These commands are used to prepare the 
terminal for communications with a host, describe and 
position the dialog area, specify what kinds of errors 
the terminal should report, control peripheral devices, 
and so on. 


You can enter setup commands when the terminal is in 
Setup mode. When the red light in the SET UP key is 
on, the terminal is in Setup mode. The setup commands 
are discussed in Section 6. 


The terminal “remembers” most setup commands after 
it is turned off and then turned back on. That means 
that you don’t need to enter the same setup commands 
every time you use the terminal unless you want to 
change some of the setup parameters. 


There is also a set of commands called “escape 
sequences” which you can enter in Setup mode. 


LOCAL MODE 


The LOCAL key initiates or terminates Local mode. 
When the terminal is in Local mode, it is as if it were 
not connected to a host computer. Data which would 
normally be sent to the host is interpreted as if it came 
fram the host. Host input that comes to the terminal 
while it is in Local mode is stored in a queue and is 
executed when Local mode is terminated. If the dialog 
area is in use, text entered in Local mode appears in 
the dialog area. 


ERROR REPORTING 


When the 4112 detects an error condition, it is 
recorded in an internal error queue and may be 
displayed on the screen. There are four levels of errors. 
You can establish the error threshold, which 
determines whether or not an error message is dis- 
played on the terminal (see ERRORLEVEL in 

Section 6). 


The terminal’s error messages are listed in Appendix A. 


THE DISK DRIVE 


The terminal’s optional flexible disk drive can be used 
for local mass storage of graphics and text data. It is 
easily operated by a group of setup commands. See 
Sections 3 and 6 for details. 
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THE KEYBOARD 


The 4112's keyboard (Figure 1-2) is described in detail 
in Section 2. It's features include: 


@ A typewriter-like keyboard for typed input 


@ Pre-programmed command keys for commonly used 
features 


@ Programmable keys 


@ Indicator lights to inform you when the terminal is in 
a particular mode, or transmitting or receiving data 


@ Viewing keys to manipulate segments 


@ Thumbwheels to scroll the dialog area, control the 
graphics input, and define a new view when the 
terminal is in Framing mode. 


REAR PANEL FEATURES 


The following connectors, switches, and features are 
located on the 4112 rear panel and are shown in Figure 
1-3. 


@ AC Power Cord Connector — This connector ac- 
cepts the female end of a standard 110V/220V AC 
60-Hz power cord. This cord is provided with the 
terminal as a standard accessory. 


e@ Fuse holder — The main power fuse is located just 
under the power cord connector. SEE CAUTION 
BELOW. To remove the bad fuse, unscrew the cover 
on the fuse holder with a flat blade screwdriver; the 
fuse pops out when the cover is removed. 
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Ifa fuse burns out this may indicate a fault in the 
equipment. First, find and remedy the problem 
(call a qualified service person). Then, replace the 
fuse with the one of proper value (3AG 6.25A, for 
125 V operation). 


@ Configuration/Options label — This label lists all of 
the options installed in the terminal at the factory. If 
you are not sure whether a particular option is 
installed in your terminal check this label. 


@ To Modem RS-232 (connector) — This connector 
accepts a standard RS-232 cable and connects to 
the host computor via a direct line or a modem/TIA' 
and telephone line. 


'MODEM means data line MOdulator/DEModulator. 


TIA means Terminal Interface Adapter. 
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@ SELF TEST and RESET buttons — These switches @ EXT SYNC — The connector accepts an input from 
are for test purposes only and should not be used by an external video synchronization source (only on 
the operator. See the 4112 Service Manual for ; Option 11 equipped terminals). 
complete service information related to these con- 
trols. @ 3-PORT PERIPHERAL INTERFACE — Consists of 

three RS-232 type connectors; only on Option 10 

@ Hard Copy Connector — This connector provides a (SPPI) equipped terminals. 
hard copy output and accepts a cable froma 
TEKTRONIX hard copy unit. ® GRAPHIC TABLET connector — Provides 

connection to TEKTRONIX graphic tablets; only on 

Optional connectors: Option 13/14 equipped terminals. 


@ VIDEO OUT2— This connector supplies a standard 
video signal to an external monitor (on Option 11 
equipped terminal). 


“This connector is only installed on terminals equipped with Option 12. 


MASTER SELF VIDEO * SPPI * 
RESET TEST - OUT INTERFACE 
EXT * 
SYNC 


AC POWER 
CONNECTOR 


HARD COPY 


FUSE 
CONNECTOR 


GRAPHIC * 
TABLET 
CONNECTOR 


LINE VOLTAGE CONFIGURATION/ RS232 
SELECTOR OPTIONS LABEL HOST 
SWITCHES CONNECTOR 


* OPTIONAL 
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Figure 1-3. Rear Panel Features. 
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HOST COMMUNICATIONS 


The 4112 communicates with the host computer via a 
direct line or a modem/TIA and telephone line. An RS- 
232 host connector is located on the rear panel of the 
4112. See Figure 1-3. 


First, connect the AC power cord to the mating 
connector on the rear panel of the terminal. Plug cord 
into power source. Then connect the RS-232 cable to 
the connector labeled: TO MODEM RS-232 (aiso on 
rear panel of terminal). Connect the free end of this 
cable to the modem. Power up the 4112 and verify 
proper host communications by logging on to your host 
system. Log off when finished. 


OPTIONAL COMMUNICATIONS 


Option 01 provides block mode and half-duplex com- 
munications. Section 5 provides a brief overview of 


communications concepts. Section 6 includes explana- 
tions of commands which control communications. The 


Host 4112 Programmer's Manual and the 4110 Series 
Command Reference Manual have more detailed 
communications information. 


PERIPHERALS 


The 4112 is compatible with most other Tektronix 


peripheral devices, such as plotters, printers, and hard 
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copy units. See Section 3 for details. 


4112 OPERATOR'S 


Section 2 


CONTROLS, INDICATORS, AND KEYBOARD 


This section is divided into two sub-sections. The first second sub-section is a description of the terminal’s 


explains the terminal's controls and indicators. The keyboard. 


CONTROLS AND INDICATORS 


The terminal’s controls and indicators include the 
following: 


® power switch 


@ MASTER RESET button 

@ SELF TEST button 

@ WRITE PROTECT switch (optional) 
@ WRITE PROTECT indicator (optional) 
® disk drive indicator lamp (optional) 
@ REFRESH INTENSITY knob 

@ KBD LOCK lamp 

@ PAGE FULL lamp 

@® XMT lamp 

@® RCV lamp 

@ thumbwheels 

TURNING THE TERMINAL ON 


To turn the terminal on, push the power switch 

(Figure 2-1). Release it when it clicks. A green indicator 
appears in the switch. You should also hear the 
ventilation fan inside the terminal turn on. 
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Figure 2-1. The Power Switch. 
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Do not biock the air vents in the top of the 
terminal's cabinet (Figure 2-2). If you do, the 
terminal could overheat and damage its circuitry. 
These air vents allow proper ventilation. 
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The Power up Sequence 


Each time you turn the terminal on, it automatically 
tests parts of its memory and circuitry. This is called 
the “power up sequence.” It takes from 15-60 seconds 
depending on what options your terminal has, and 
requires no operator interaction. 


During the power up sequence the lights in the 
keyboard (Figure 2-3) go through the following 
sequence: 


@ Ail lights turn on. 

@ The CAPS LOCK light turns off. 

@ All other lights turn off. 

@ The XMT and RCV lights flash once simultaneously. 
@ All lights turn off. 


If the terminal bell does not ring during the power up 
sequence (within 60 seconds of turning the terminal 
on), the cursor flashes in the upper left corner of the 
screen. If the dialog area is enabled (see “DIALOG” 
later in this section) the cursor appears on the first 
available line of the dialog area. As soon as the cursor 
appears on the screen, the terminal is ready for use. 


If the power up Sequence detects an error the terminal 
bell rings one, three, or four times, depending on the 
severity of the problem. There may also be a message 
on the screen. If this occurs, see Appendix B. 
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Figure 2-2. The Air Vents. 


POWER UP 
INDICATOR LIGHTS 


Figure 2-3. Keyboard Indicators in Power Up Sequence. 


2-2 


4112 OPERATOR'S 


Power Up Defaults 


Much of the terminal's operating environment when it is 
turned on (power up defaults) depends on its environ- 
ment when it is turned off. 


Many elements of the operating environment can be 
altered under program control or by “setup com- 
mands.” The results of many of these changes are 
stored in “setup memory” and are remembered the 
next time the terminal is turned on. Table 6-1 (in 
Section 6) indicates the parameters which are saved in 
setup memory. 


Setup commands and Setup mode are discussed in 
this section under the heading “SET UP” and in 
Section 6. 


Table 6-1 also indicates the ‘factory default” operating 
environment of the terminal. “Factory default" means 
the setting which the terminal has when it is shipped 
from the factory. The status of your terminal is different 
from what is shown in that table if the parameters were 
altered by setup commands. See the STATUS com- 
mand in Section 6 for information on how to determine 
the environment of your terminal. 


If the setup memory fails, the operating environment is 
reset to the factory default. If this has happened, you 
are informed by a message during the power up 
sequence (see Appendix B). 


At times you may want to reset the terminal to all of its 
default parameters yourself. For this procedure, see 
Appendix B. 


MASTER RESET 


NOTE 
Do not press the MASTER RESET button if there 
is important information stored in the terminal's 
memory. Resetting the terminal deletes all 
graphics data as well as macros which have been 
programmed into keys. 


Use the MASTER RESET button (Figure 2-4) when you 
want to return the terminal to its power up condition. 
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Pressing the MASTER RESET button has the same 
effect on the circuitry as if the terminal were turned off 
and back on: 


@ Macros are deleted from programmed keys. 


@ Graphics data is deleted from the terminal's 
memory. 


@ The terminal runs its power up sequence. 


@ The screen is erased. 


You can save information before resetting the terminal 
by making a hardcopy of the screen (the HARD COPY 
key is explained later in this section). If your terminal 
has a flexible disk (Option 42) you can copy data toa 
disk or to a host file (see Section 3). 


When you press the MASTER RESET button in con- 
junction with the SELF TEST button, an extensive self 
testing procedure is initiated. 


SELF TEST 


MASTER RESET 


Figure 2-4. The MASTER RESET and SELF TEST Buttons. 
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SELF TEST 


The power up sequence is an abbreviated test of the 
terminal's memory and circuitry. 


A more extensive test of the terminal's operating 
conditions is initiated by the SELF TEST button 
(Figure 2-4). The SELF TEST thoroughly tests the 
terminal and allows a service technician to make any 
necessary adjustments. Self test is more fully ex- 
plained in Appendix B. 


The SELF TEST can also be used to reset all terminal 
parameters to their factory default values. See Appen- 
dix B for details. 


WRITE PROTECT SWITCH AND 
INDICATOR 


Your terminal may have a flexible disk drive (Option 
42). If it does, the drive is located to the right of the 
display. There is a WRITE PROTECT switch for the disk 
drive. The switch is located in the panel above the drive 
(Figure 2-5). 


If there is no disk in the drive, the red indicator light is 
always on. It cannot be turned off. 


When there is a disk in the drive and you press the 
WRITE PROTECT switch toward the disk drive, the light 
next to the switch turns on. This means that the disk in 
the drive is ‘write protected.” When a disk is write 
protected, the terminal will not write data on it. This 
prevents you from writing over (and thus destroying) 
data already on a disk. 


Press the switch to the right to terminate the write 
protection feature (and turn off the light). You can also 
protect a disk by the PROTECT setup command (see 
Section 6) or by covering the “write protect” notch in 
the disk itself (see Section 3). 


For additional details on the use of the WRITE 
PROTECT switch and information on use of the disk 
drive, see Section 3. 


DISK DRIVE INDICATOR LAMP 


When the red light in the disk drive door (Figure 2-5) is 
on, the drive is either reading from or writing to the 
disk. When the light is off, the drive is not operating. 
The use of the disk drive is explained in Section 3. 


WRITE PROTECT 
SWITCH 


WRITE PROTECT 
INDICATOR 


DISK DRIVE 
INDICATOR 
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Figure 2-5. The WRITE PROTECT Switch, Indicator and Disk Drive Indicator. 
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Do not open the disk drive’s door when the drive 
is operating (the red light is on). To do so 
interrupts the READ or WRITE in progress. Wait 
until the READ or WRITE is finished, then remove 
the disk. 


INTENSITY 


The brightness of the display is controlled by the 
INTENSITY knob (Figure 2-6). Turn the knob to the 
right to make the display brighter. Turn it to the left to 
make the display less bright; if you turn the knob too 
far to the left, text or graphics on the display becomes 
invisible. 


KBD LOCK 


When the KBD LOCK light (Figure 2-7) is on, the 
keyboard is “locked.” A program can lock the keyboard 
to prevent you from typing anything at a time which 
would interfere with data being sent from the host. 


When the keyboard is locked, you can still press the 

keys, but data is not transmitted, echoed, or queued. 

When you press any key (except BREAK or CANCEL) 
the terminal's bell rings to remind you that no data is 

being input. 


The program should unlock the keyboard when the 
transmission of the critical data is complete. 


You can also unlock the keyboard by pressing the 
MASTER RESET button or the CANCEL or BREAK 
keys. However, you should use MASTER RESET, 
CANCEL, and BREAK with caution. The MASTER 
RESET button deletes information in the terminal’s 
memory. The CANCEL key terminates several terminal 
functions besides the locked keyboard. And the BREAK 
key may have undesirable effects on some host 
computers. 


For further details, see the explanations of MASTER 
RESET, BREAK, and and CANCEL in this section and 
the LOCKKEYBOARD command in Section 6. 


PAGE FULL 


When the PAGE FULL light (Figure 2-7) is on, the 
terminal will not display any more text or graphics until 
the “page full” condition is cleared. The ‘page full” is 
cleared when you press any key except the SHIFT. 
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The terminal can be set up to make a hard copy of the 
screen, erase the screen, and continue automatically. 
See the PAGEFULL setup command in Section 6 for 
details. 


XMT 


The abbreviation “XMT" stands for “transmit.” The 
transmit light (Figure 2-7) is on when data is being sent 
from the terminal to the host computer. 


RCV 


The abbreviation “RCV” stands for ‘receive.’ The 
receive light (Figure 2-7) is on when data is being 
received by the terminal from the host computer. 


INTENSITY 
KNOB 


Figure 2-6. The INTENSITY Knob. 


Figure 2-7. The KBD LOCK, PAGE FULL, XMT and RCV 
Indicator Lights. 
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THE THUMBWHEELS 


The thumbwheels (Figure 2-8) have three uses: 
®@ to scroll the dialog area. 


@ to locate a point on the screen to be sent toa 
graphics program being run from a host computer. 


@ to manipulate the framing box when the terminal is 
in Framing mode. 


The dialog area is discussed later in this section, under 
the heading “DIALOG.” Using the thumbwheels when 
the terminal is in graphics input (GIN) mode and to 
manipulate the framing box are discussed later in this 
section. 


Figure 2-8. The Thumbwheels. 


THE KEYBOARD 


The keyboard can be grouped into six categories: ALPHANUMERIC KEYS 


Alphanumeric Keys Most of the keyboard looks like a typewriter 


Control Keys (Figure 2-9). The alphanumeric keys transmit the 
characters shown on their keycaps to the terminal or to 
The BREAK Key a host computer. These are also called “printing” 
Command Keys characters since they have symbolic representations 
which are “printed” (echoed) on the screen or printed 


Function Keys by a line printer. 


winwi 
lewind keys The “space” is a printing character. 


Figure 2-9. The Alphanumeric Keys. 
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NOTE 


Four optional keyboards are available for 
international use. Descriptions 

in this section apply to the standard keyboard. 
There are variations if your terminal has an 
optional keyboard. 


If you hold down an alphanumeric key for more than 
half a second, the character repeats at a rate of 10 

times per second until you release the key or press 
another key. 


When the terminal is in Local or Setup mode and you 
press an alphanumeric key, it is displayed (echoed) on 
the screen. Whether or not the characters are echoed 
when you are logged onto a host computer depends on 
whether the terminal or the host is providing the echo. 
See the ECHO command in Section 6 for details. 


The character normally transmitted by an alphanumer- 
ic key can be replaced by a “macro” (a character or 
character string programmed into the key). This is 
explained later in this section under the heading 
“Function Keys.” 


CONTROL KEYS 


The terminal can send and receive all standard control 
characters. A “control character’ is a character that 
has a special meaning for the terminal or host compu- 
ter. When some control characters are transmitted, you 
may not see them echoed or see their result on the 
display. 
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Several control characters have a specific meaning to 
the terminal. For example, the “carriage return” control 
character causes the cursor to return to the left 
margin; the “line feed” control character causes the 
cursor to move down one line. 


There are six control characters which have their own 
keys (Figure 2-10): 

@ RUB OUT (delete) 

BK SPC (back space) 

LINE FEED (line feed) 

RETURN (carriage return) 

ESC (escape) 

TAB (horizontal tab) 


The CTRL and SHIFT keys are included in the following 
description of the control keys because they are used 
to specify control characters which are not 
represented on the keyboard. 


RUB OUT 


The RUB OUT key sends the “rub out” (or delete”) 
character. 


The RUB OUT is the factory default ‘character delete” 
key in Setup mode. See the explanation of the 
EDITCHARS command in Section 6. 


RUBOUT 


LINE FEED 


BKSPC 


RETURN 
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Figure 2-10. The Control Keys. 
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BK SPC 


The BK SPC key sends the “back space” character, 
which moves the cursor one character position to the 
left. 


lf the cursor is already at the left margin when you 
press the BK SPC key, it moves to the right margin of 
the same line. 


LINE FEED 


This key sends the “line feed” character, which causes 
the cursor to move down to the next line without 
returning it to the left margin. 


If the cursor is at the bottom of the screen and is not in 
the dialog area, a line feed moves it to the top of the 
screen or causes a “page full” condition (see PAGE- 
FULL in Section 6). 


You can use the setup command LFCR to cause a line 
feed received from the host computer (or from the 
terminal when it is in Local mode) to cause the terminal 
to generate a carriage return (see Section 6). 


RETURN 


The RETURN key sends the “carriage return” control 
character, which returns the cursor to the left margin of 
the current line. 


Some host computers automatically include a “line 
feed” when they echo or send the “return” character, 
$0 that pressing the RETURN key moves the cursor 
down one line and to the left margin. If your host does 
not, you can use the setup command CRLF (explained 
in Section 6) to cause the terminal to include a line 
feed with the return character. 


When in Setup mode, the terminal automatically pro- 
vides a carriage return-line feed when you press the 
RETURN key. 


ESC 


The termina! sends the escape character when it is 
communicating with a host computer and you press 
this key. 


The “escape” is the first character in a special 
sequence called the “escape sequence.” These are 
commands issued to the terminal in a special format in 
Local and Setup modes. See Appendix C for details. 


For detailed explanations of all escape sequence 


commands, see the 4112 Host Programmer's Refer- 
ence Manual. 
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TAB 
The TAB key transmits the horizonal tab character. 


Depending on how your host defines a tab, this 
character can cause the cursor to move a number of 
spaces to the right. 


When the terminal is in Local mode, the cursor moves 
one character to the right each time you press the TAB 
key. 


CTRL 


Some control characters are used often and have their 
own keys, such as RETURN and LINE FEED. 


However, you can also transmit these characters and 
all other control characters by holding down the CTRL 
key while you press another key. 


For example, press the CTRL key and the "G" key 
(CTRL-G) at the same time to send the “bell” character 
and cause the terminal bel! to sound; CTRL-M sends a 
“carriage return’ character and causes the cursor to 
return to the left margin; CTRL-J sends the “line feed” 
character and causes the cursor to go down one line. 


SHIFT 


Most keys have two meanings: “unSHIFTed” and 
“SHIFTed.” 


When you press the key labeled “W” while holding the 
SHIFT key, the terminal sends the upper case 
character (W); pressing the same key without the 
SHIFT (if the CAPS LOCK key light is not on) sends the 
lower case letter (w). Some keys are labeled with two 
non-alphabetic characters, one above the other. For 
example, press the key labeled “5” to transmit a 5; 
press the same key and the SHIFT key to send the 
percent (%) character. 


Programmable function keys can also have shifted and 
unshifted meanings, as explained elsewhere in this 
section under the heading ‘Function Keys.” The com- 
mand keys, (see “Command Keys” elsewhere in this 
section) have shifted and unshifted functions pro- 
grammed into them as labeled on the keyboard. 


The SHIFT key is also used at the same time as the 
CTRL key to send some control characters. 
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The BREAK key (Figure 2-11) can be used to “inter- 
rupt” communications from some host computers to 
the terminal. It is in a category by itself because it does 
not actually send a character to the host. It alters the 
state of the communications line such that the 
computer stops the sending of information to the 
terminal or stops the execution of a program. 


The length of time that the interrupt lasts is important 
to some host computers. You can use the setup 
command BREAKTIME to specify the length of the 
interrupt sent by the terminal to the host, or to disable 
the BREAK key, as explained in Section 6. 


CONTROLS/INDICATORS/KEYBOARD 


It is also important that various host computers react 
differently when they receive the BREAK. One host 
might stop the execution of a program while another 
may log you off the host and break the communications 
link to the computer. Therefore, before using the 
BREAK key or BREAKTIME command, you should find 
out how the interrupt is handled by your host. 


Pressing the BREAK key also unlocks the keyboard 
(see ‘KBD LOCK” earlier in this section.) 


BREAK 


3683-11 
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Figure 2-11. The BREAK Key. 
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COMMAND KEYS 


There are six command keys (Figure 2-12) which 
perform special functions or put the terminal into a 
particular mode of operation. These keys cannot be 
programmed to do any other function. Their purpose is 
to allow you to easily access frequently used terminal 
features. 


The functions performed by the command keys are 
discussed in the following order: 

@ PAGE 

CAPS LOCK 

SET UP 

DIALOG 

CLEAR 

LOCAL 

CANCEL 

COPY 


PAGE 


When you press the PAGE key, the following items are 
erased in the current view: 


® graphics that are not part of a graphics segment (a 
“graphics segment” is a picture or part of a picture 
which can be manipulated by 4112 commands). 


@ text that is not part of a graphics segment and not in 
the dialog area. 


The following are erased momentarily and then re- 
drawn when you press the PAGE key: 


the dialog area. 

@ segments visible in the current view. 
® the framing box. 
e 


border around a viewport. 


A segment is permanently erased by being deleted 
from the terminal’s memory. A segment can also be 
made “invisible” (not erased from the terminal's memo- 
ry, but not visible either). After a segment has been 
deleted or made invisible, you may need to press the 
PAGE key to erase its image from the screen, depend- 
ing on how the terminal’s FIXUP parameter is set (see 
Section 6). 


If the dialog area is not enabled (see “DIALOG” 
elsewhere in this section) the following actions occur 
when you press the PAGE key. Because of these 
actions, it is generaily best not to press PAGE while a 
program is running and the dialog area is not enabled. 
(These actions do not take place if the dialog area is 
enabled.) 


@ the cursor returns to the “home” position (the upper 
left corner of the screen). 


@ the terminal goes into alpha mode (that is, it 
interprets all incoming data as alphanumeric data, 
not graphic data). 


@ the linestyle is set to solid. 
® 4010-style graphics input (GIN) mode is terminated. 
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Figure 2-12. The Command Keys. 
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CAPS LOCK 


The CAPS LOCK key is similar to the “Shift Lock” key 
on a typewriter. 


When you press CAPS LOCK, the red light in the key 
comes on and alphabetic characters are transmitted in 
upper case. The CAPS LOCK does not cause the upper 
case version of numeric, command, or function keys to 
be transmitted. 


The CAPS LOCK allows you to easily send only 
uppercase alphabetic characters to the host, but still 
allows you to conveniently send numeric characters 
rather than special symbols. This is especially useful 
on host systems which do not accept lowercase 
alphabetic characters. 


SET UP 


When you press the SET UP key, the light in the key 
turns on and the terminal enters Setup mode. (If the 
dialog area is enabled, the light in the DIALOG key also 
turns on. See the discussion of the dialog area later in 
this section.) With the terminal in Setup mode you can 
type English-like commands (called ‘‘setup” 
commands) directly to the terminal. 


Setup commands allow you to establish the terminal's 
operating environment and to use peripherals attached 
to the terminal. For example, setup commands are used 
for such things as establishing communications rates, 
inquiring about the terminal's status, determining what 
kinds of errors the terminal should display, and pro- 
gramming special meanings (macros) into keys. 
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The results of many setup commands are stored in 
setup memory. Specifications stored in the setup 
memory are remembered even if the terminal is turned 
off, unplugged, plugged in, and turned on again. 


See Section 6 for a description of Setup mode and all 
of the setup commands. 


DIALOG 


Part of the screen can be used to display your 
“conversation” (dialog) with the terminal and the host 
computer. This portion of the screen is called the 
“dialog area.” 


The text which can be written in the dialog area 
includes: 

®@ the terminal's error messages. 

® commands entered in Setup mode. 


®@ text entered in Local mode (most commands entered 
in Local mode are not echoed on the screen). 


® non graphics (alpha) text included in a graphics 
program. 


® host generated messages, such as: 
prompts 
warnings 
error messages 


® normal terminal/host communications. 


See the explanation of the CLEAR key later in this 
section for details on how to erase text from the dialog 
area. 
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Enabling the Dialog Area. Alpha text is directed to the 
dialog area when the dialog areais enabled. When the 
dialog area is disabled, alpha text is displayed with 
graphics. The DAENABLE command is used to enable 
or disable the dialog area. As illustrated in Figure 2-13, 
if the dialog area is enabled, the alpha text is directed 
to the dialog buffer. The dialog buffer can be thought of 
as a scroll, part of which is displayed at a time, ata 
specified screen location. 


Whether or not the dialog area is enabled is stored in 
setup memory. For example, if you enable the dialog 
area and turn the terminal off, it will be enabled the 
next time you turn the terminal on. 


4010-Compatibility. If a program is written to be run 
on the 4112, the terminal can distinguish between text 
which is part of the graphics (‘graphics text” such as 
titles and labels) from text which is not part of graphics 
(non-graphics, or “alpha” text). Graphics text is dis- 
played with the graphics. Alpha text is sent to the 
dialog area. Programs written for 4010 Tektronix 
terminals can also be run on the 4112, but special 
consideration must be made for text since those 
terminals do not have a dialog area. 


For example, you can run a program on the 4112 which 
was originally written for a 4010 terminal. If the 
program includes text (such as a title or labels) and the 
dialog area is active, the 4112 would strip the title and 
labels out of the picture and display that text in the 
dialog area. 


DAENABLE 


This is the reason for the DAENABLE command. When 
the dialog area is “disabled,” the 4112 does not 
intercept text and display it in the dialog area, allowing 
a 4010-style program with text to execute on a 4112 
just as on a 4010-family terminal. 


Dialog Area Visibility. Even if the dialog area is 
enabled, it must also be made visible so you can see 
the text which is sent to it. If the dialog area is enabled 
but not visible, dialog is written in the dialog area but 
neither the text nor the cursor is visible. 


The DIALOG key is used to make the dialog area 
visible or not visible. When the red light in the key is on, 
the dialog area is visible. When the red light in the key 
is off, the dialog area is not visible. (You can also use a 
setup command called DAVIS to make the dialog area 
visible or not visible, see Section 6.) 


If the dialog area is enabled when you turn on the 
terminal, the light in the DIALOG key turns on, the 
dialog area is visible, and the cursor is displayed in the 
dialog area. If the dialog area is not enabled when you 
turn on the terminal, the dialog area is not visible and 
the cursor appears in the upper left corner of the 
screen. 


ALPHA TEXT 


DIALOG 
BUFFER 
(DABUFFER) 


WINDOW 
(DALINES) 


Figure 2-13. Enabling the Dialog Area. 
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Dialog Area Buffer. You can specify the total size of 
the dialog buffer with the DABUFFER command. This 
command allocates a certain amount of the terminal’s 
memory for a buffer in which the dialog is elotre: The 
factory default is 34 lines. 


When the dialog buffer is full, the first line is deleted so 
another line of dialog can be added to the end. 


The maximum length of each Sine is specified by the 
DACHARS command. 


Visible Portion of the Dialog Area. It is not usually 
necessary or desirable to have the entire dialog buffer 
visible. The DALINES setup command specifies the 
number of visible lines in the dialog buffer. The factory 
default is five lines. 


When the dialog area is visible you can use the top 
thumbwheel (Figure 2-8) to move (scroll) through the 
dialog area to observe its entire contents. As you 
“scroll,” you are moving the “window” shown in Figure 
2-13, so different lines in the dialog area are visible. 
The cursor stays on the line below the last line of 
dialog. This assures that information sent to the dialog 
area while you are examining it does not overwrite 
information already in the dialog area. 


Line Length. The maximum length of each line in the 
dialog area is specified by the DACHARS setup 
command. The factory default is 80. 


Dialog Area Writing Mode. The DAMODE setup com- 
mand specifies whether a character in the dialog area 
is overwritten or replaced when you backspace over it. 
The factory default condition is ‘replace.’ That means 
that when the dialog area is enabled and visible and 
you backspace over a character, it is erased. The other 
setting is “overstrike.” That means that when the dialog 
area is enabled and visible and you backspace over a 
character, the terminal writes over the character 
without erasing it. 


A special “character delete” key is used to backspace 
in Setup mode. See the EDITCHARS command in 
Section 6. 
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Dialog Area Position. You can position the dialog area 
anywhere on the screen. The DAPOSITION command 
specifies the location of the lower left corner of the 
dialog area. The terminal positions the last visible line 
of the dialog area as close as possible to that location. 


For example, the factory default position is the lower 
left corner of the screen (0,0). This means that the 
dialog area is located such that the last visible line (the 
fifth line, by factory default) begins at the lower left 
corner of the screen. 


If you alter the configuration of the dialog area and 
move it, the location may not be exactly the one you 
specify. This is because the number of visible lines and 
length of each line may not permit the dialog area to be 
displayed at the location you specified. 


Dialog Area Gray Scales. The DAINDEX setup com- 
mand specifies the three indices (gray scales) in the 
dialog area: 


@ the “character index” specifies the gray index used 
for text in the dialog area. 


@ the “background index” specifies the gray index for 
the background of the dialog area. 


® the ‘wipe index” specifies the gray index to which 
the dialog area is set when it is erased (wiped). 


CLEAR 


To erase the dialog area, press the SHIFT and DIA- 
LOG/CLEAR keys at the same time. This clears all text 
from the dialog buffer. The result is that the dialog area 
is erased. It does not erase any graphics on the screen 
(unless it is on the same surface) or affect whether or 
not the dialog area is visible. 
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LOCAL 


When you press LOCAL, the red light in the key turns 
on and the terminal enters Local mode. !f the terminal 
is already in Local mode, pressing the key turns the 
light off and terminates Local mode. 


When in Local mode, communications to and from the 
host computer are temporarily suspended. Everything 
typed at the keyboard is interpreted by the terminal as 
if it came from the host. Information or data received 
from the computer is not processed: it is put into a 
queue and processed when you exit from Local mode. 


Figure 2-14 illustrates the flow of communications. 
Notice that when the terminal is in Local mode, data 
transmission is routed back to the terminal instead of 
being sent to the host. 


In Local mode you can enter commands (‘‘escape 
sequences’) from the keyboard in the same format that 
a host uses and the terminal executes them as if they 
came from the host. 


If both Setup and Local modes are active, Setup takes 
priority. 


OUTPUT 


INPUT 


CANCEL 
Press the SHIFT-LOCAL keys at the same time to 
initiate a CANCEL operation. The CANCEL: 


®@ halts all disk, host, and 3PPI file copy operations 
(except spooling, see Section 6). 


®@ cancels “bypass” mode (see BYPASSCANCEL in 
Section 6). 


® terminates graphics input (GIN) mode (see 
Section 4). 


@ unlocks the keyboard (LOCKKEYBOARD in 
Section 6). 


If a file transfer is cancelled (see COPY in Section 6) 
the file is closed. All information in that file operation 
up to the time of the CANCEL command is preserved. 


HOST 
COMPUTER 


Figure 2-14. Communications Flow in Local Mode. 
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COPY 


If you have a hard copy unit attached to the terminal, 
you can make hard copies of the display. You can copy 
the display either normally or in “inverse video.” 


A compatible hard copy unit must be attached to the 
terminal (see Section 3) and the terminal and hard 
copy unit must both be turned on. The hard copy unit 
may need to be on for a few minutes to warm up before 
it can make a good quality copy. 


To copy normally, simply press the COPY key. If you 
are using the factory default gray indices, this copies 
black text and graphics on a white background. 


To make an inverse video copy, press the SHIFT and 
COPY keys at the same time. if you are using the 
factory default gray indices, this copies white text and 
graphics on a black background. 
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The hard copy operation takes about ten seconds. Data 
sent to the terminal during the hard copy operation is 
queued until the hard copy is finished. Data transfer 
operations and other non-display terminal functions 
continue while the hard copy is being made. 


FUNCTION KEYS 


Most of the terminal's keys are programmable. This 
means that you can define the character or character 
string that is transmitted when you press a particular 
key. The character string or individual character as- 
signed to a key is called a “macro.” 


The eight programmable function keys (Figure 2-15) 
transmit nothing unless they are programmed. The 
alphanumeric and control keys have characters 
assigned to them, but they can be assigned a macro 
instead. 


FUNCTION 
KEYS 


Figure 2-15. Programmable Function Keys. 
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Most keys can have two macros (shifted and unshift- When the terminal is reset or turned off, macros are 
ed). There is no shifted version of some keys, so they deleted from the terminal’s memory. The DEFINE 

can have just one macro. A few keys are reserved for command can also be used to delete macro or return a 
specific commands and cannot be programmed. Figure key to its original meaning. 


2-16 illustrates keys which are not programmable. 


The DEFINE setup command (see Section 6) is used to 
program a macro into a key. When you press a key that 
has a macro programmed into it, the key is “expanded” 
into the macro. 


COMMAND 
KEYS 


VIEWING 
KEYS 


BREAK 
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Figure 2-16. Non-programmable Keys. 
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THE VIEWING KEYS 


The terminal's four viewing keys (Figure 2-17) allow 
you to examine the graphics display in more detail. 


The PAN and ZOOM keys put the terminal into Framing 
mode. There are several additional functions, as indi- 
cated by the labels on the other viewing keys: VIEW, 
OVERVIEW, NORMAL, NEXT VIEW, RESTORE, and 
BORDER. 


The terminal's display can be divided into as many as 
64 separate viewports. When there is more than one 
viewport, graphics actions (such as graphics input and 
Framing mode) take place in the viewport which is 
“currently active.” The currently active viewport can be 
selected by program control or by pressing the termi- 
nal’s NEXT VIEW key. 


NOTE 


If the bell rings when you press any of the viewing 
keys, they have been disabled by the terminal's 
“lock viewing keys” comand. To “unlock” the 
viewing keys, put the terminal into Setup mode 
and enter the following: 


<EC>RJ 0 <CR> 


Framing Mode 


When you press the ZOOM or PAN keys, the terminal 
enters Framing mode. In Framing mode, a framing box 
appears at the edge of the currently active viewport. 
You can change the location or shape of the framing 
box with the thumbwheels. The box frames the portion 
of the view you want to see in more detail. 


The graphics displayed on a 4112 is defined in an area 
4096 horizontal units by 4096 vertical units. The 
screen normally displays 4096 x 3127 units (a 4:3 
aspect ratio). 


The screen does not display the full resolution of the 
4096 x 3127 space. Therefore, you can ‘zoom’ into a 
picture and see more detail. As you zoom into a picture, 
you can also move across or up and down to identify a 
smaller portion of it (the pan function). 
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If the light in the ZOOM key is off, when you press the 
ZOOM key the light turns on and the terminal enters 
Framing mode with the zoom function active. When the 
zoom function is active, the lower left and upper right 
corners of a rectangle appear in the framing box. 


When you rotate the top thumbwheel up or the bottom 
thumbwheel to the right, the height and width of the box 
are increased. When you rotate the top thumbwheel 
down or the bottom thumbwheel to the left, the height 
and width of the box are decreased. In both cases, the 
framing box maintains its current aspect ratio. 


The framing box represents the proposed new view 
(window). When you make the box smaller, you are 
zooming in for a closer look. When you make the box 
bigger you are zooming out for an enlarged view. 


When you have positioned the box where you want it, 
press the VIEW key to update the display. The viewport 
is erased and the portion of the window within the 
framing box is displayed in the viewport. The framing 
box again appears at the edge of the viewport. 


Figure 2-17. The Viewing Keys. 
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You can zoom in to 1/16th the size of the current 
window. if you want to zoom in more than that, press 
the VIEW key to update the viewport and then zoom in 
on that view. 


You can zoom out on a view until it is about eight times 
its current size. If you want to zoom out more, press the 
VIEW key to update the viewport and then zoom out on 
that view. 


If you press the SHIFT key while you rotate the 
thumbwheels, the box changes shape more slowly, 
allowing you to more precisely change the window. 


See the explanation of the RESTORE key for 
information on restoring a previous view. 


If you press the CTRL key while you rotate a 
thumbwheel, you alter the aspect ratio of the framing 
box. Press the CTRL key while you rotate the top 
thumbwheel to change the height of the box while not 
affecting its width. Press the CTRL key while you rotate 
the bottom thumbwheel to change the framing box's 
width while not affecting its height. Press the SHIFT 
and CTRL keys while you rotate a thumbwheel to 
change the aspect ratio more slowly. 


See the explanation of the NORMAL key for information 
on restoring the original aspect ratio. 


Zooming occurs in the currently active viewport. To 
zoom in on another viewport, use the NEXT VIEW key 
as explained later in this section. 


Terminate the zoom function by exiting from Framing 
mode or by making the pan function active. When the 
light is on in the ZOOM key, you exit from Framing 
mode by pressing the ZOOM key. The light in the key 
turns off as Framing mode is terminated. Make the pan 
function active by pressing the PAN key. The light in 
the ZOOM key turns off and the light in the PAN key 
turns on. 


You can use both the zoom and pan functions before 
you update a view. For example, you could press the 
ZOOM key and zoom in, then press the PAN key to pan 
across a view, then press ZOOM again, and so on until 
you have the framing box located correctly. Then press 
the VIEW key. 
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The PAN Function 


If the light in the PAN key is off, when you press it the 
light turns on and the terminal enters Framing mode 
with the pan function active. A dashed-line box ap- 
pears at the edge of the currently active viewport, with 
a cross in the center of the box. 


When you rotate the top thumbwheel up or down, the 
framing box moves up or down. When you rotate the 
bottom thumbwheel left or right, the framing box moves 
to the left or right. The position of the box represents 
the proposed new view (window). 


When you have positioned the box where you want it, 
press the VIEW key to update the display. The viewport 
is erased and the new view, as specified by the framing 
box, is displayed. The framing box again appears at the 
edge of the viewport. 


You can pan until an edge of the framing box reaches 
the edge of the terminal (4096 x 4096) space or until 
only about 1/8 of the framing box is still in the current 
view, whichever happens first. If you have not reached 
the edge of the viewport and you want to pan more, 
press the VIEW key to update the current view and pan 
across that view. 


If you press the SHIFT key while you rotate a 
thumbwheel, the framing box moves more slowly 80 you 
can locate it more precisely. 


You can pan in the currently active viewport. To pan in 
another viewport, use the NEXT VIEW key as explained 
later in this section. 


Terminate the pan function by exiting from Framing 
mode or by making the zoom function active. When the 
light is on in the PAN key, you exit from Framing mode 
by pressing the PAN key. The light in the key turns off 
as Framing mode is terminated. Make the zoom func- 
tion active by pressing the ZOOM key. The light in the 
PAN key turns off and the light in the ZOOM key turns 
on. 


You can use both the Zoom and Pan sub-modes before 
you update a view. For example, you could press the 
ZOOM key and zoom in, then press the PAN key to pan 
across a view, then press ZOOM again, and so on until 
you have the framing box located correctly. Then press 
the VIEW Key. 
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As described with the ZOOM and PAN keys, the VIEW 
key is used to update the view described by the 
framing box. 


If you press the CTRL and VIEW keys at the same time, 
the view described by the framing box is displayed in 
the viewport with the next higher identifier (see the 
NEXT VIEW key). However, the framing box remains 
active in the current viewport. 


For example, you may have two viewports defined on 
the screen. One large one containing a large picture, 
and a smaller viewport. You can zoom into a small 
portion of the large picture and press the CTRL-VIEW 
keys. The specified detailed view is displayed in the 
smaller viewport. This provides a detailed view as 
specified, but also leaves an overview of the larger 
picture visible. The framing box continues to be active 
in the current (larger) viewport. 


The OVERVIEW Key 


When you press the OVERVIEW key (SHIFT and PAN 
keys at the same time) the entire amount of terminal 
space normally displayed (4095 x 3127) is made 
visible. If the pan or zoom function is active, it remains 
active and the framing box is visible. 


If you press the CTRL and OVERVIEW keys (CTRL- 
SHIFT-PAN) at the same time, the entire 4095 x 4095 
terminal space is displayed. (Notice that this changes 
the aspect ratio from its normal 4:3 to a 4:4 ratio.) If the 
pan or zoom function is active, it remains active and the 
framing box is still visible. To restore the normal (4095 
xX 3127) view and aspect ratio, press the OVERVIEW 
key. 


See the explanation of the RESTORE key for informa- 
tion on how to restore the original view. 


The NORMAL Key 


As included in the explanation of the Zoom sub-mode, 
you can change the aspect ratio of the framing box by 
pressing the CTRL key while rotating a thumbwheel. 


If you then press the VIEW key, the view is updated 
with the same aspect ratio as the framing box. To 
cause the framing box to return to its normal (4:3) 
aspect ratio, press the NORMAL key (the SHIFT and 
ZOOM keys at the same time). 


The NEXT VIEW Key 


When the display contains more than one viewport, the 
terminal internally identifies each viewport with an 
integer value. You can make the view with the next 
larger identifier active by pressing the NEXT VIEW key. 


4112 OPERATOR'S 


CONTROLS/INDICATORS/KEYBOARD 


You can make the view with the next smaller identifier 
active by pressing the CTRL key at the same time as 
the NEXT VIEW key. When a viewport becomes visible, 
a border around that viewport blinks once to indicate it 
is active. 


You can then use the Framing mode and viewing key 
functions in that viewport. 


The RESTORE Key 


The terminal remembers the last three views for each 
viewport, as well as the view before you change it with 
any of the viewing keys (that is, the view as it was 
defined by the last “window” command as explained in 
the 4110 Series Command Reference Manual). To 
restore the most recent view, press the RESTORE key. 
To restore the second most recent, press it again. 
Press it a third time to restore the third most recent 
view. Since the three most recent views are saved, this 
list of views Changes every time you press the VIEW 
key. For example, when you press the VIEW key: 


@ The third most recent view is deleted. 


@ The second most recent view becomes the third 
most recent. 


@ The most recent view becomes the second most 
recent. 


@ The current view becomes the most recent. 


@ The contents of the framing box becomes the 
current view. 


lf you press RESTORE a fourth time, the terminal 
restores the view as it was before you altered it with a 
viewing function. This original version of the view is not 
replaced when you press the VIEW key, as the three 
most recent views are. This means that you are always 
able to return the view to its original condition. 


You can immediately restore the view as it was before 
you altered it with a viewing function by pressing the 
CTRL and RESTORE keys at the same time. 


If you press the RESTORE key a fifth time, you see the 
most recent view again. If you press it a sixth time you 
see the second most recent view again, and so on. 


The BORDER Key 


You can cause the terminal to draw a border around 
the current viewport by pressing the BORDER key. If 
that viewport already has a border, pressing the key 
deletes the border. 
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Section 3 


HARDWARE OPTIONS AND PERIPHERALS 


This section explains the use of the disk drive and This section also includes instructions on the use of 
three port peripheral interface (SPP) options to the the following TEKTRONIX peripheral devices with the 
4112. It also explains how to attach the optional terminal: 


graphics tablets to the terminal. Since the tablets are 


@ 4 4 i 
always used for graphics input, their use is explained Be eand te Le Tiardeony VAS 


in Section 4. @ 4634 Imaging Hardcopy Unit 
@ 4662 and 4663 Plotters 
® 4923 Tape Drive 
THE DISK DRIVE 
Figure 3-1 shows a 4112 terminal with a flexible disk local storage of segments, macros, text fonts, and 
drive built into it (Option 42). The disk drive is used for general text data. 


WRITE PROTECT 
SWITCH 


WRITE PROTECT 
INDICATOR 


DOOR BAR 


DISK DRIVE 
INDICATOR 


DISK DRIVE 
DOOR 
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Figure 3-1. The Flexible Disk Drive. 
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HOW TO INSERT A DISK 


Figure 3-2 illustrates the front and back sides of a 
flexible disk. 


To insert a flexible disk, open the door to the drive by _ 
pushing the disk drive's door bar to the left (Figure 3- 
1). Insert the disk notched edge first, with the label to 
the left (Figure 3-3). Slide the disk in enough that it 
stays, but not hard enough to bend the disk. Push the 
door to the right to close it. 


Remove the disk when you are through using it by 
pushing to the left on the door bar. The door will open 
and your disk will pop out. 


PPP IOI IO 


: CAUTION Q 
4 
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Do not remove a disk while the light in the disk 
drive's door is lit; it indicates that the disk is in 
operation. Removing an operating disk halts the 
operation in progress, and may damage or de- 
stroy your data. 
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Figure 3-3. Inserting a Flexible Disk. 


Figure 3-2. Flexible Disks. 
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HANDLE THE DISKS WITH CARE 


Flexible disks are easy to store and handle. It is 
important to take a few simple precautions to insure 
the integrity of your data. 


Do not bend flexible disks intentionally since they 
crease and tear, which destroys the data stored on 
them. Oil, dirt, and dust on the disk cause problems 
when the disk head tries to read the disk, so touch only 
the paper sleeve when handling the disk. Always keep 
the disks in jackets when not in use. Disks should be 
stored in a place protected from dust, extreme heat 
(above 122°F, 50°C) and extreme cold (below —40°F, 
—40°C). 


if you are storing critical data on the disk, it is always 
safest to back up the data with a second copy. 


The disk should last for about 3,500,000 read/write 
operations per track or 30,000 insertions, whichever 
comes first. When the disk begins to wear out you will 
see translucent rings around its edges. You will also 
notice repeated errors when you try to read from or 
write to the disk. When this occurs, discard the disk 
and use the backup. 


WRITE PROTECTING A DISK 


There are three ways to protect a disk or files on the 
disk from being inadvertently deleted or overwritten by 
different data. 


The WRITE PROTECT switch (Figure 3-1) on the disk 
drive protects the entire disk. When the write protect 
feature is active, the red light in the switch is on and 
you cannot format, delete a file from or add a file toa 
disk in that drive. An error results whenever you 
attempt to do so. 
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You can also use the setup command PROTECT to 
protect an entire disk or individual files on the disk. 
Using the PROTECT command does not prevent you 
from reformatting a disk; it only prevents you from 
writing to or copying from a disk. See the explanation of 
the PROTECT command in Section 6. 


Some disks also have a “write protect” notch in them. If 
the disk you use has a write protect notch, you cannot 
write to the disk when that notch is exposed. Before 
writing to the disk, you must cover the notch with a 
piece of opaque tape. 


USING THE DISK DRIVE COMMANDS 


The following brief example illustrates the use of a disk 
drive. It includes the use of the FORMAT, SAVE, 
DIRECTORY, LOAD, PROTECT, and DELETE com- 
mands. This example also uses the DEFINE command 
to create three macros, which are then saved to a disk 
file. You may need to read the explanation of DEFINE in 
Section 6 prior to doing the example. 


All of the commands related to the disk drive are briefly 
presented in Table 3-1, following this example. 


Insert a disk, following the directions under the 
heading ‘How to Insert a Disk” earlier in this section. 
Be sure that the disk does not contain information that 
should be saved. 


Put the terminal in Setup mode. If the light in the SET 
UP key is not on, press the key. If it is already on, the 
terminal is already in Setup mode. 


Be sure the disk is not write protected. Toggle the ° 
WRITE PROTECT switch to the left position (the red 
light in the switch should be off). If the disk has a write 
protect notch, be sure it is covered with a piece of 
Opaque tape. Enter the following setup command to 
assure that the disk has not been protected by the 
terminal: 


PROTECT FO: no °r 
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FORMAT Fe: eq crne> <5 2E> 
/ Nes fate. 
Enter the following command to “format” the disk — 
prepare it for the creation of files: 


*~FORMAT PRACTICE 368 Cr 


A disk must be formatted the first time it is used, to 
prepare the disk for storing files. Do not format a disk 
that has already been formatted unless you want to 
destroy ail of the files on that disk and start over. 


While the disk is being formatted, the red light in the 
disk drive's door comes on indicating that the disk 
drive is operating. It takes about 60 seconds to format 
the disk. Continue with the next step in the example 
when the red light goes out. (Do not open the disk 
drive's door while the disk is being formatted.) 


The parameters indicate that the disk in drive 0 should 
be named “PRACTICE” and that the maximum number 
of files allowed on the disk is 368. 


Program macros into keys F1, F2, and F3 with the 
following DEFINE command. Remember that the “liter- 
al” character must precede the carriage return which is 
included in the macro. In this example the tilda (~) is 
the literal character. It is shown above the °r because 
when you use it the cursor backspaces and the Cr 
types over it. See the DEFINE and EDITCHARS 
commands in Section 6 for details. 


DEFINE F1 /STATUS Cn / Cr 

DEFINE F2 /STATUS DIALOG °r / Cr 

DEFINE F3 /STATUS BAUDRATE Cp / oR 

PAGEFULL STOP Sr 

Press F1, F2, and F3 to be sure they are programmed. 
A general status report, the status of the dialog area 
and of the BAUDRATE command should be displayed. 


When the “page full’ condition occurs, press any 
alphanumeric key or PAGE to continue. 


Save the macros onto the disk with the following 
command: ; 

SAVE MAC ALL TO KEYS £r 

This command saves all of the macros currently 


defined. The file on the disk in drive O that the 
segments are saved to is named “keys.” 
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Display a directory of the disk with the following 
command to be sure that the file was created. A 
directory similar to the one in Figure 3-4 is displayed. 


DIRECTORY Cr 


Press the terminal’s RESET button (located on the 
back of the terminal). The terminal goes through the 
power up procedure. Among other things, this deletes 
the macros currently programmed into the keys. 


Press function keys F1, F2, and F3. The terminal 
takes no action because the macros have been 
deleted. 


Press the SET UP key to put the terminal back into 
Setup mode. 


Load the macros into the terminal from the disk by 
entering the following command: 


LOAD KEYS Cr 


The red light in the disk drive door turns on indicating 
that the disk is operating. When it finishes loading the 
specified file, the light in the door turns off. 


Press F1, F2, and F3. The macros which you saved 
have been programmed back into the function keys by 
the LOAD command. 


tDIRECTORY 

-NAME BLOCKS BYTES PROTECT 

F@:PRACTICE ebbe NO 
KEYS 36 NO 


-ENTRIES USED: 


-ENTRIES FREE: 
-ELOCES USED: 
-ELOCES FREE: 
-LAFGEST FREE: 
¢ 


Figure 3-4. A Disk Directory. 
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Delete “KEYS” from the disk by entering the following 
command: 


DELETE KEYS “rn 


Enter the DIRECTORY command to be sure that the 
file was deleted: 


DIRECTORY Cr 


The directory should no longer include the file named 
“KEYS,” 


Enter the following command to restore the default 
PAGEFULL condition: 


PAGEFULL NONE Cn 


DISK DRIVE COMMANDS 


Table 3-1 briefly introduces all of the terminal’s setup 
commands relating to the operation of the disk drives. 
The abbreviation (PPI) appears next to those com- 
mands which are also used by the three port peripheral 
interface, which is explained later in this section. See 
Section 6 for detailed explanations of all setup com- 
mands. 
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Table 3-1 


THE DISK DRIVE COMMANDS 


Command 


COPY (3PPI) 


DELETE 
DIRECTORY 


FORMAT 


LOAD 


PLOT (3PPI) 


PROTECT 


RENAME 


SAVE 


SPOOL (3PPI) 


Explanation 


Copies data from one device to 
another. 


Deletes a specified file trom a disk. 


Displays a directory of an entire disk 
or individual files. 


Initializes a disk so data can be 
stored on it in files. 


Reads data from a disk arid executes 
it as if the data were a command file. 


Reads information from the termi- 
nal’s screen and sends it toa 
specified output device. 


Write protects or unprotects files on 
a disk. 


Assigns a new name toa file ona 
disk. 


Creates a file on a disk containinga 
graphics segment or special text 
font. 


Copies data from one device to 
another, while still allowing the termi- 
nal to proceed as usual. 


Halts the spooling operation. 
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THE THREE PORT PERIPHERAL INTERFACE 


The 3PPI, Option 10, allows the terminal to communi- Table 3-2 
cate with peripheral devices. With the 3PPI installed THE THREE PORT PERIPHERAL 
(Figure 3-5), the terminal supports most devices which INTERFACE COMMANDS 
communicate through an RS-232 interface. 
we Command Explanation 
The TEKTRONIX 4662 and 4663 plotters are explicitly 
supported by the 3PPI. PASSIGN Assigns a device driver to a port. 
Table 3-2 briefly introduces the commands associated PBAUD Specifies the baud rate for a port. 
with the terminal's 3PPI. PBITS Specifies the stop bits and data bits 
for a port. 
USING THE 3PPI PCOPY Establishes a two-way communica- 
tion path between two devices. 
To use the 3PPI, plug the RS-232 cable from the device i : 
into one of the ports in the interface. You then use a PEOF Seas the end of file string for a 
setup command to assign an appropriate device driver pet 
to that port. PEOL Specifies the end of line string fora 
port. 
For example, you could connect a 4663 plotter to port O ; ; 
of the 3PPI. You would put the terminal into Setup BEtae rae nee flagging convention 
mode and enter the following command: ae 
PORT i ifi 
PASSIGN PO: 4663 Cr ORTSTATUS Sete a report on the specified 
Establishes the parity convention 


PPARITY 
- used by a port. 


ALLS soneimmaran 


Figure 3-5. The Three Port Peripheral Interface (3PPI). 
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This command assigns the terminal's 4663 “device 
driver” to peripheral port 0. The device driver trans- 
lates terminal commands into 4663 commands when 
the terminal sends data to the plotter, and 4663 
commands into terminal commands when the plotter 
sends data to the terminal. See the PASSIGN command 
in Section 6 for more complete information. 


The 3PPI supports any device with an RS-232 connec- 
tor with its “general device driver.” The general device 
driver does not translate commands from one format to 
another. 


In addition to assigning a device driver to a port, you 
must also be sure that communications parameters are 
set correctly. It is important for correct data transmis- 
sion that the parameters assigned to the port agree 
with the parameters of the device attached to the port. 
The parameters and the setup commands used to set 
them are: 


® baudrate (PBAUD) 
flagging (PFLAG) 

stop bits (PBITS) 

data bits (PBITS) 

parity (PPARITY) 

end of line string (PEOL) 
end of file string (PEOF) 


For full information on the above commands please see 
Section 6, the Command Reference section. 


ATTACHING THE 4662 AND 4663 
PLOTTERS 


Plug the male end of an RS-232 cable into a 3PPI port 


and the female end into the MODEM port on the back of 
the plotter. 
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The plotter is often connected between the host port 
and the terminal. However, if you wish to use all the 
capabilities of the terminal, connect the plotter to the 
terminal’s S3PPI port and let the terminal drive the 
plotter. 


When the terminal and plotter are connected, you must 
make Sure that the parameters are set properly. Use 
the 4662 and 4663 Plotter Operator Manuals for 
information on how to set the communications 
parameters. 


ATTACHING THE 4923 OPTION 1 
TAPE DRIVE 


You can attach a TEKTORNIX 4923 Option 1 Tape 
Drive to a 4112 peripheral port, using the terminal’s 
general device driver. 


Plug the RS-232 cable into the MODEM port on the 
4923 and into one of the peripheral ports on the 
terminal. If it is plugged into peripheral port 0, for 
example, you would use the following command: 


PASSIGN PO: PPORT Sr 


Use the PBAUD command to match the port's baud rate 
to the tape drive's, as indicated by the 4923’s baud 
rate contral knob on the back of the tape drive. 


Use the terminal's PFLAG command to set character 
flagging to DC1/DC3. All other communicatons param- 
eters should be set to match the conventions used in 
the files on the tape. 


When the terminal is receiving data from a non-file- 
structured device, such as the 4923, you can indicate 
the “end-of-file” by pressing the terminal’s CANCEL 
key after all data has been transferred. This erases the 
last received data which would otherwise be left inside 
the 3PPI system. 
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THE GRAPHICS TABLETS 


The two graphics tablets are Options 13 and 14 to the 
terminal. 


Option 13 is 11” x 11’ and Option 14 is 30” x 40”. 
Except for their size, the two tablets are identical. In 
this manual! they are both referred to as “the graphics 
tablets” or “the tablets” since operating instructions 
are the same for both. 


This manual assumes that the hardware for the tablet 
is installed and that it is ready for use. If that is not the 
case, a qualified technician should follow the installa- 
tion instructions included in the 4110 Series F13/14 
Graphics Tablet Instruction Manual. 


Figure 3-6 shows the smaller graphics tablet. Both 
tablets include: 

® the tablet (with cables connected to it) 

@ the tablet interface 


@ the input devices (one or more of the following): 
a stylus (standard) 
a one button cursor (optional) 
a four button cursor (optional) 


_RBNISSOS ENSURE 


® a bar magnet for restoring the tablet’s bias 
® a precision grid (optional) 
Table 3-3 lists the terminal's setup commands which 


deal specifically with the operation of the tablet. See 
Section 6 for more details. 


Table 3-3 
TABLET SETUP COMMANDS 


Command Explanation 


TBFILTER Specifies the time and distance fil- 
tering the tablet is to use for strokes 


in Graphics Input mode 


TBHEADERCHARS Specifies the header characters 
used by the tablet when it sends data 
to the host program via 4010-style 


GIN. 


TBSTATUS Specifies whether a STATUS byte is 
included in GIN reports when using 


4010-style GIN. 


Figure 3-6. The 4112 and (Option 13) Graphics Tablet. 
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ATTACHING THE TABLET It is important to plug the correct cable into the correct 
outlet. If they are crossed, the tablet will not function 

Figure 3-7 illustrates how to plug the cables into the properly. 

graphics tablet interface. The cable from input device 

(stylus, one-button, or four-button cursor) goes into the The cable coming from the back of the interface plugs 

connector on the right; the cable from the upper left into the connector on the back of the terminal labeled 

corner of the tablet goes to the middle connector; and “TO GRAPHIC TABLET.” 

the cable from the lower right corner goes to the left 

connector. 


LOWER RIGHT 
CORNER 


UPPER LEFT 
——™~ CORNER 


STYLUS 


TABLET 
INTERFACE 


3683-21 


Figure 3-7. How to Attach the Tablet. 


4112 OPERATOR'S : 3-9 


OPTIONS 


THE STYLUS 


There are two different kinds of fillers for the stylus. 
One is a ballpoint filler, the other filler is a “blank” so it 
won't draw lines. You can use either of these fillers, 
depending on your needs. 


To change the filler, unscrew the bottom part of the 
stylus just as you would a ballpoint pen. Gently pull the 
filler straight down. Be careful not to break either of the 
two probes (Figure 3-8). Insert the other filler and 
screw the stylus back together. 


POSITIONING THE PRECISION GRID 


The precision grid is an optional accessory to the 
graphics tablet. If you have one, the grid can be used to Figure 3-8. Taking the Stylus Apart. 
help you enter data more precisely. 


The procedure for positioning the grid on the tablet is 
included in the 4110 Series F13/14 Graphic Tablet 
Instruction Manual. 


CLEANING THE TABLET SURFACE 


Clean the tablet as often as necessary, using a damp 
cloth and a mild detergent, such as window or glass 
cleaner. Do not immerse the tablet in water or get it too 
wet. Never use a cleaner that contains hydrocarbons, 
since they will disolve the tablet surface. 


RESTORING THE TABLET BIAS 


About once a week you should use the following 
procedure to restore the tablet's magnetic bias. You 
can use this procedure more often if the tablet begins 
to relay incorrect data or if the graphics cursor moves 
erratically. 


Figure 3-9. Restoring the Tablet’s Bias. 


1. Turn the terminal off and unplug it. 
Disconnect the tablet from the interface. 


Pull the magnet across the tablet from the upper 
left corner towards the lower right corner ina 
single, smooth motion (Figure 3-9). Wipe the entire 
surface in about two or three seconds. 


4. Connect the tablet again, plug the terminal back in, 
and turn the termina! back on. 


You should store the magnet away from the tablet and 
other magnetically sensitive items (such as flexible 
disks and magnetic tapes). 
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HARDCOPY UNITS 


The 4112 terminal is compatible with the TEKTRONIX 
4612 and 4632 Hardcopy Units and the 4634 Imaging 
Hardcopy Unit. (Attach them by running the hardcopy 
cable from the copier to the interface in the back of the 
terminal (Figure 3-10). 


The hardcopier should be running for about 10 minutes 
before you use it. After this period of time, it can make 
a good quality copy. To make a copy, press the HARD 
COPY key on the terminal or the COPY button on the 
copier. 


NOTE 


If the copies made by your 4612, 4632, or 4634 
are distorted on the left side, your hardcopy unit 
needs to be adjusted. Contact a service techni- 
cian or see the 4612 Service Manual, 4632 
Service Manual, or 4634 Instruction Manual for 
details. 


For more details on the HARD COPY key see Section 2 
of this manual. See the operator’s manual for the 4612 
and 4632 hardcopy units for further operating instruc- 
tions, or the Instruction manual for the 4634 Imaging 
Hardcopy Unit. 


3683-22 


Figure 3-10. How to Attach a Hardcopy Unit. 
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EXTERNAL VIDEO OPTION 


The External Video option (Opt. 11) provides a 30-Hz 
RS-1 70/330 video output so the terminal's graphics 
data may be displayed on an external video monitor. 
This option produces a standard studio video signal, 
with or without serration and equalization pulses (See 
NOTE below). The external video output signal termi- 
nates on a standard BNC type connector on the 
terminal's rear panel, see Figure 3-11.Usea standard 
cable to connect between the termina!’s video output 
connector and the monitor's video input connector. 


if all terminals and monitors in your system are 
synchronized to a master sync signal, connect a BNC 
cable from the sync source to the terminal connector 
labeled EXT SYNC. 
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After the video signal cable (and sync cable, if any) are 
connected between the terminal and the monitor, turn 
on the power to both units. The terminal's display 
image will appear on the terminal screen and the 
external monitor screen. If the monitor image is not 
stable (rolls, etc.) adjust the sync controls as on any 
video monitor or television set. 


NOTE 


Serration and equalization pulses aid in vertical 
and horizontal synchronization of the picture, 
much like an ordinary television set. If your 
system requires any changes to the video output 
signal, call your TEKTRONIX field service repre- 
sentative or refer to strapping and service 
information in the TEKTRONIX 4112 Service 
Manual. 
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Figure 3-11. External Video Connectors. 
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Section 4 


GRAPHICS INPUT MODE 


Graphics input (GIN) mode allows you to send graphics 
information to a program. 


Usually a host resident program will put the terminal 
into GIN mode and prompt you for certain information. 
You can use escape sequence commands in Setup 
mode to put the terminal in GIN mode. 


The program should also prompt you concerning what 
kind of data you should enter. For example, it might tell 
you to locate a certain number of points on the screen 
(the “locate” function), to “pick” a certain “menu item” 
or part of the picture (the picking function), or to 
stroke" (draw) something on the screen. 


The devices that can be used to send graphics 
information to a program (GIN devices) are: 


@ the terminal’s thumbwheels 
@ a 4662 or 4663 plotter 


@ a graphics tablet 


An explanation of how to position the graphics cursor 
with each input device and how to use each of the 
functions is included in this section. 


THE PICK FUNCTION 


A program may be written such that you are to choose 
between several actions. This list of actions is called 
the “menu.” The program would instruct you to “pick” 
the desired action. To do so, position the graphics 
cursor near the description of the appropriate action. 
The way that you signal the program that the cursor is 
at the position you want to “pick” depends on the input 
device you are using. They are each described later in 
this section. 


You may also be asked to pick a part of the picture to 
be moved, enlarged, reoriented, or changed in some 
way. Again, you would position the graphics cursor 
near the object and signal the program that the cursor 
is at the location you want to pick. 


THE LOCATE FUNCTION 


Move the graphics cursor to the appropriate point on 
the screen. When it is properly located, signal the 
program that you have located the cursor. The input 
device sends the coordinates of that point to the 
program, and it is acted on accordingly. 
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THE STROKE FUNCTION 


The graphics tablet allows you to draw lines as you 
move the stylus along the surface of the tablet. (The 
terminal draws lines between points when it is using 
inking but the lines appear only on the screen; they are 
not saved) 


INKING 


As you locate points on the screen, lines between 
these points may be drawn. If this occurs, the terminal 
is using the “inking function.” 


RUBBERBANDING 


When you move the cursor a line may “follow” the 
graphics cursor. One end of the line is anchored at the 
last point and the other end of the line is attached to 
the graphics cursor. This function is called ‘rubber 
banding.” It allows you to draw a line more precisely 
from one location to another. Rubberbanding works 
with the locate and pick functions. 


GRIDDING 


For the locate and pick functions, the program may also 
specify that an invisible ‘‘grid” be in effect on the 
screen. When a grid is active, you can only locate the 
cursor on points where the vertical and horizontal lines 
of the grid intersect. This allows you to precisely 
position the cursor when it is necessary to draw lines 
that intersect at a 90 degree angle. 


There is a setup command called GRIDDING which 
allows you to easily establish a grid for the input 
device. See Section 6. 


When you move the graphics cursor it may “Jump” from 
one point to the next. If this happens, you will know that 
gridding is in effect and the cursor is moving between 
points on the grid. 


FILTERING 


For the stroke function you can set time and distance 
values to specify the number of points the terminal will 
send to the program. 
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USING THE TERMINAL’S THUMBWHEELS 


When the terminal is in GIN mode, a graphics cursor 
appears on the screen. The default is the ‘crosshair 
cursor’ (Figure 4-1). However, the program can select 
another graphics entity to be the graphics cursor. 


Position the graphics cursor with the thumbwheels 
(Figure 4-2). As the arrows indicate, the top 
thumbwheel moves the graphics cursor up and down 
and the bottom thumbwheel moves it back and forth 
across the screen. 


if you hold the SHIFT key at the same time as you 
rotate a thumbwheel, the cursor moves more slowly so 
you can position it more precisely. 


When you have positioned the graphics cursor where 
you want it, you send the location of that point to the 
program by pressing any alphanumeric key. When you 
press the key, the crosshair cursor blinks momentarily 
ag the point is transmitted to the program. Do not press 
the RETURN key, as that causes invalid data to be 
transmitted. 
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CROSSHAIR 
CURSOR 


Figure 4-1. The Crosshair Cursor. 


Figure 4-2. The Thumbwheels. 
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USING THE TABLET 


When you use a graphics tablet for a GIN device the You can locate points in an 11" by 11” square on the 
graphics cursor will be visible on the screen. The smaller tablet (Option 13) and a 30” by 40” area on the 
crosshair cursor (Figure 4-1) is the default graphics larger tablet (Option 14). This is called the ‘active 
cursor, but the program can select any graphic entity writing area.” In both cases the center of the active 

as the cursor. The applications program should inform writing area is the center of the tablet. 


you what is the graphics cursor if it is not evident. 


When the tabiet is active, you can use one of three 
input devices: the stylus, a single button cursor, anda 
four button cursor (Figure 4-3). 


INTERFACE 


BOX 
TABLET 


MAGNET 


PRECISION 
GRID 


1-BUTTON 4-BUTTON 
STYLUS ahi CuiRSGA 


aoe enanes S SSNS  L 


Figure 4-3. The Option 13 Graphics Tablet. 
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THE STYLUS AND ONE-BUTTON CURSOR 


Hald the stylus as you would a ballpoint pen, with the 
tip resting on the tablet. The cursor on the terminal 
screen tracks with the stylus as you move it. The tablet 
can keep track of the stylus as long as it is with 5/32 of 
an inch of the tablet surface. 


Lay the cursor flat on the tablet surface with the button 
facing up. As you move the cursor along the surface of 
the tablet, the graphics cursor tracks with it. 


For the pick and locate functions, when you locate the 
appropriate point on the tablet or terminal display, 
press down on the stylus. The stylus’ tip moves slightly 
and the graphics cursor blinks momentarily as the 
point is transmitted to the applications program. For the 
cursor, press the button to pick or locate a point. 


For the stroke function, press the stylus or cursor 
button down and move the stylus or cursor across the 
tablet surface as if you were drawing on it. The number 
of points transmitted to the program depends on the 
setting of the TBFILTER command (see Section 6). 
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THE FOUR-BUTTON CURSOR 


Lay the cursor flat on the tablet surface with the 
buttons facing up. As you move it along the surface of 
the tablet, the cursor tracks with it. 


The functions of the four buttons can be defined by the 
applications program. For example, one button might 
cause inking to be used, another button may erase the 
line between the next two points, the third could 
implement the stroking function, and so on. The 
applicatons program should inform you how to use the 
buttons. 


If the buttons are not programmed, you can press any 
of the four buttons to transmit the current location of 
the graphics cursor to the applications program. 
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USING THE 4662 OR 4663 PLOTTER 


The 4662 and 46693 plotters can also be used as For additional operating instructions, see the 4662 or 
graphics input devices (Figure 4-4). Use the plotter’s 4663 Operator's Manual. 

joystick to position the pen at the appropriate location. 

To indicate to the program that you have located the 

point you want and you are using a 4662, press the the 

plotter’s CALL button. If you are using a 4663 plotter, 

press the plotter’s DRAW POINT button. 
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Figure 4-4. The 4112 and 4663 Plotter. 
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Section 5 


COMMUNICATIONS OVERVIEW 


This section provides an overview of the terminal's 
communications modes. For detailed information on 
these subjects, see the 4112 Host Programmer's 
Manual, a system manual for your host, or a systems 
programmer for your host. 


In most cases communications parameters are set by 
program control and not by an operator. However, since 


Some communications parameters are crucial. For 
example, if the host and terminal have conflicting baud 
rates, there can be no communications. Similarly, if the 
host checks for even parity and the terminal is set up 
for odd parity, there will be communications problems. 
It is important for the operator to have some under- 
standing of basic communications considerations to 
avoid some obvious problems. 


there are setup commands which allow these condi- 
tions to be set by an operator, the concepts are 

introduced in this manual. And, there are some com- 
mands (such as BAUDRATE) which would usually be 


set by the operator. 


Table 5-1 lists all of the setup commands which deal 
with communications. Commands under the heading 
“Standard Commands” are standard for the terminal. 
Those under the heading “Optional Commands” are 
part of the communications option (Option 01). 


The concepts which these commands introduce are 
discussed in the rest of this section. 


Table 5-1 
COMMUNICATIONS COMMANDS 


Standard Explanation 

Commands 

BAUDRATE Specifies transmit and receive baud 
rates 

BREAKTIME Specifies length of break 
transmission 

BYPASSCANCEL Specifies bypass cancel character 

EOFSTRING Specifies end of file string 

EOLSTRING Specifies end of line string 

EOMCHARS Specifies end of message characters 

FLAGGING Specifies whether flagging is used 
and what kind 

PARITY Specifies how parity is checked 

PROMPTMODE Specifies whether or not terminal is 


PROMPTSTRING 


in Prompt mode 


Specifies prompt string 


QUEUESIZE Specifies size of terminal's input 
queue 

STOPBITS Specifies number of stop bits used 

XMTDELAY Specifies time terminal waits after 
transmitting an end of message char- 
acter before resuming transmission 

XMTLIMIT Sets upper limit of terminal's 
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tranmission rate 


Optional 
Commands 


BCONTINUECHARS 


Explanation 


Specifies block continue characters 


BENDCHARS Specifies block end characters 
BHEADERS Specifies block header sequences 
BLENGTH Specifies block length 


BLINELENGTH 


Specifies maximum line length for 
Block mode 


BLOCKMODE “Arms” or “disarms” the terminal for 
Block mode 

BMASTERCHARS Specifies block master characters 

BNONXMTCHARS Specifies block non-transmittable 
characters 

BPACKING Specifies manner in which blocks 
are packed for transmission and re- 
ceiving 

BTIMEOUT Specifies how long terminal waits 
before retransmitting previous block 

DUPLEX Specifies Duplex mode 
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STANDARD COMMUNICATIONS 


The terminal’s standard communications feature all 
facilities necessary to support 1/O with most host 
computers. These include: 


@ full duplex 

@ RS-232-C compatibility 
@ Prompt mode 

® flagging 


“Full duplex” implies that the terminal can send and 
receive data at the same time. Whether or not this 
actually occurs depends on whether the host is 
capable of sending and receiving data simultaneously. 


Each character is transmitted as soon as you press the 
key. Likewise, each character is processed as soon as 
it is received from the host. 


“Prompt mode” and “flagging” are explained later in 
this section. 


COMMUNICATIONS CONCEPTS 


The following concepts and terminology apply to 
standard communications, as well as communications 
in Block mode, and half duplex. 


BAUDRATE 


The baud rate is the rate at which data is transmitted 
between the host and the terminal. As used in this 
manual, the term “baud rate’ means “bits per second.” 
Transmission at a rate of 9600 baud means 9600 bits 
per second, or approximately 960 characters per 
second. 


The factory default baud rate is 2400. You can use the 
setup command BAUDRATE command to modify it. The 
transmit and receive baud rates can be set indepen- 
dently. 


It is important that the terminal and the host be set to 
communicate at the same baud rates. If not, data will be 
misinterpreted or not communicated at all. You can use 
the STATUS command, as explained in Section 6 of 
this manual, to determine the terminal's current trans- 
mit and receive baud rates. 
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PARITY 


The accuracy of the transmission of data can be 
verified in many different ways. One way is to check 
the ‘parity’ of each character after it is sent. 


Each character is coded into eight binary digits (bits) 
with a value of O or 1. The first seven bits define the 
character. The eighth character is often used fora 
parity check. 


“Even” parity means that the sum of the bits is always 
even. That is, when the sum of the bits of a character 
add to an even number, the eighth bit is set to O; if the 
sum is an odd number, the eighth bit is set to 1. 


Similarly, “odd” parity means the sum of the bits must 
always be an odd number. 


“None” means that the parity is always 0, “High” 
means that the parity bit is always set to 1. “Data” 
means that the eighth bit is part of the character being 
transmitted instead of being used as a parity check. 


The terminal’s parity must always be set to match the 
host computer's needs. The terminal ignores the parity 
bit on characters the host transmits to it. 


FLAGGING 


It may be necessary for the terminal and the host to be 
able to inform each other when they are ready to 
receive data and when transmission should be 
temporarily suspended. 


For example, the terminal has an input queue into 
which data is collected until it can be processed. When 
the input queue is full, any additional! data which the 
host tries to send to the termina! would be lost. 


However, the terminal can send a character (called a 
“flag") to stop data transmission from the host when its 
input queue is full. When there is more room in the 
queue, another flag is sent to tell the host to resume 
transmission. 


Since this is not useful on all hosts and since some 
hosts require different kinds of flagging, the setup 
command FLAGGING allows the operator or a program- 
mer to define the flagging parameters. 
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QUEUESIZE 


The terminal processes data as soon as it receives it 
from the host. However, if data is coming to the terminal 
at a high baud rate, it may not be able to process it as 
quickly as it is received. 


When the terminal is in Block mode, it waits until it has 
received a complete block of data before it begins to 
process it. 


In both of these cases, the terminal stores data in an 
input queue until it can process it. 


The size of the queue can be specified by the 
QUEUESIZE command. Its size depends on the host 
computer, the rate of transmission, the kind of com- 
munications link used, and other installation dependent 
factors. The factory default is 300 bytes. 


XMTLIMIT 


Sometimes the rate at which a host computer can 
effectively receive data is less than the maximum 
possible for the baud rate at which the communictions 
port is specified. 


For example, a time-share host may not be able to 
receive data at 9600 baud, even though you are logged 
onto a 9600 baud port. In such a case, you could leave 
the terminal's transmit baud rate setting at 9600 but 
set the transmit limit parameter (established by the 
XMTLIMIT command) to a level with which the host can 
cope — perhaps 8000. The termina! then sees to it that 
data is not transmitted at a rate faster than 8000 baud. 


The baud rate is not actually changed, but the charac- 
ters transmitted are spaced apart so that the number 
transmitted per second is the same as if the baud rate 
were the transmit limit rate. 


The factory default transmit limit is 19200 baud. If your 
host can receive data at speeds up to 19200 baud, you 
do not have to be concerned with the transmit limit. 
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BREAKTIME 


There will be occasions when you need to interrupt the 
transmission of data from the host or halt a host 
program. One way to do so is with the BREAK key. 


The BREAK key sends an interrupt transmission to the 
host. The length of the interrupt is set by a command 
called BREAKTIME. The factory default BREAKTIME 
parameter is set to 200 ms. However, it may be need to 
be longer or shorter — and on some hosts you may not 
want to use the BREAK key at ail. In that case, 
BREAKTIME can be set to Oms. 


EOLSTRING 


The “end of line string” indicates the end of the 
transmission of a line of data. It is sent by the terminal 
at the end of (or during) transmissions generated by 
the terminal. 


The factory default termination string is the “carriage 
return.” This works for all hosts which interpret the 
carriage return as the end of a particular line of data. 


Since you explicitly inform the host of the end of a line 
by typing a termination string (carriage return) when 
entering data from the keyboard, no special action 
must be taken by the terminal. 


However, sometimes the host requests information 
from the terminal which is sent in a different format and 
requires no operator interaction. For example, the 
program may request a report of error messages or 
some graphics input data. In such cases, the terminal 
sends an end of line character to the host to indicate 
the end of a transmission. 


The EOLSTRING command (see Section 6) is used to 
change the end of string. 
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XMTDELAY 


The terminal can be set to wait for an interval of time 
after it receives data from the host before it begins to 
transmit. Whether or not this is desirable or necessary 
depends on your host. 


The interval for the terminal is set by the XMTDELAY 
command. The delay can be set from 0 to 65535 ms 
(which is about one minute). The factory default is 0. In 
some cases, for example, a delay of 50 or 100 ms is 
necessary to allow a modem or other transmission 
equipment to “turnaround.” 


EOFSTRING 


When you are transferring files between the host and 
terminal, it is necessary to know when the file transfer 
is complete. The ‘end of file” indicator is a string of 
from one to ten ASCII characters. 


When a data file is transferred from the host to the 
terminal using a COPY or SPOOL command, the host 
must send the end of file string when it reaches the end 
of the file. The terminal sends the same string to the 
host when it reaches the end of a file it is transferring 
to the host. 


This string is defined by the EOFSTRING commana. It 
should be set to whatever the host computer sends 
when it reaches the end of a file. It is best to set this to 
the null string except when you are actually 
transmitting files, since the string is ignored by the 
terminal whenever it is detected in a host transmission. 


STOPBITS 


Each character sent between the host and terminal is 
coded into eight binary digits (bits) of data. Each of 
these eight bit codes is called a byte. 


After sending a byte of data, the host or terminal sends 
one or two extra bits to indicate the end of a byte. 
These extra bits are called "stop bits.” 


The terminal includes a STOPBITS command which 
allows you to specify whether the terminal sends one 
or two stop bits at the end of each byte. The factory 
default is 1. 
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EOMCHARS 


The “end-of-message” characters are communications 
“turnaround” characters. 


When the terminal is transmitting to the host and it 
encounters an end-of-message character, it transmits 
that character and then pauses for a period of time 
before resuming transmission. 


The period of time the terminal waits is specified by the 
XMTDELAY command. 


If the terminal is in Prompt mode, when it sees the end 
of message character it knows to wait for a prompt 
string from the host before resuming transmission. 
When the terminal is in Block mode, it first transmits 
the block, then it waits for XMTDELAY and for the next 
prompt. 


The end-of-message characters are set by the EOM- 
CHARS command. The factory default characters are 
CARRIAGE RETURN and NUL. Since “i (null) is 
ignored, setting both end of message characters to ‘. 
disables this feature. 


BYPASSCANCEL 


There are many characters which are transmitted 
between the host and the terminal which you da not 
need to or even want to see. For example, graphics 
input characters and other report characters are not 
important to an operator, yet they must be processed 
by the terminal. 


Instead of being displayed, these characters are auto- 
matically “bypassed.” The “bypass cancel character” 
is used by the terminal to assure that the correct 
characters are bypassed and that the display of 
characters is resumed appropriately. 


This character is specified by the BYPASSCANCEL 
command. The factory default is the linefeed character. 
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PROMPT MODE 


The PROMPTMODE command can be used to initiate 
and terminate Prompt mode. 


All of the communications parameters detailed under 
the ‘Standard Communications” heading are also valid 
when the terminal is in Prompt mode. 


In Prompt mode, all data to be transmitted to the host is 
kept in an output queue. It is sent when a prompt is 
received from the host. When the prompt is received 
(and the transmit delay is satisfied), data continues to 
be transmitted until an ‘end of message” character 
(specified by the EOMCHARS command) is sent. 
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The “end of message” character halts transmission of 
data and is also an indication to the host that 
transmission is over until it sends another prompt. 


The PROMPTSTRING command is used to specify the 
prompting string. The prompt string can be from one to 
ten characters, and it must conform to the actual 
prompt used by the host. 
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BLOCK MODE (OPTION 01) 


In Block mode, data is packed into blocks and 
transmitted as a unit. After each block is transmitted, 
there is a response from the device which received it 
before another block is sent. This process verifies the 
accuracy of the transmission of each block. If there 
were any errors in the transmission, the same block is 
retransmitted until it arrives in a correct form. 


Because of this format, Block mode allows easier 
transmission of full ASCII or binary code. It also 
provides error detection and automatic retransmission 
of bad data blocks. 


Block mode can be used at the same time as Prompt 
mode and in Full Duplex or Half Duplex mode. 


Specific details concerning how Block mode works are 
very complex. The 4112 Host Programmer's Reference 
Manual contains more information on Block mode. 


The BLOCKMODE command arms the terminal! for 
Block mode. The terminal actually enters Block mode 
when it receives the first block header. 


The following definitions are an introduction to the 
concepts of block mode communications. They are 
included because there are set up commands which 
specify these parameters. The syntax of each block- 


mode communications command is detailed in Secton 6. 


BLENGTH 


The maximum length of each block, for both 
transmitting and receiving, is specified by the 
BLENGTH command. 


The best size for a block length depends on several 
factors. For example, after each block is transmitted by 
either the terminal or the host, a response is required 
before the next block is sent. Therefore, the shorter the 
block, the more time is spent responding to blocks sent 
and received. However, for a long block, more time is 
spent retransmitting a block if that is necessary. 


The factory default is 256 bytes. 
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BHEADERS 


The start of each line of data in Block mode is 
indicated by a header sequence. The header sequence 
is a string of from one to ten ASCII characters. The first 
character in the sequence cannot be used elsewhere 
in the sequence; and the sequence cannot include any 
character which is part of the prompt string. 


The header sequence is specified by the BHEADERS 
command. The factory defaults are HEADTX, HEADRX. 


BCONTCHARS 


A block of data may be one or more lines long. If a 
block extends to more than one line, each line ends 
with a block continue character, indicating that more 
lines follow. There can be different block continue 
characters for transmitting and receiving. 


The block continue character is be specified by the 
BCONTCHARS command. The choice of characters 
depends on what characters the host expects. 


The default block continue characters are ampersand 
(&) for both transmit and receive. 


BENDCHARS 


A “block end” character specifies the end of a block. 
The block end character can be specified with the 
BENDCHAR command. The block end character must 
be compatible with the host software. 
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BLINELENGTH 


The block line length specification is the longest line 
that can be transmitted from the terminal that will not 
overrun the host's input buffer. Therefore, it should not 
be set to a value which exceeds the input buffer of the 
host. The default value is 70. 


There is no maximum line length for the terminal, since 
it can receive a line of any length. 


The block line length parameter is set by the BLINE- 
LENGTH command. 


BPACKING 


There are various data packing schemes available for 
host systems with limited transmission capabilities. 
That is, if your host cannot transmit full 7-bit ASCII or 
8-bit binary data, the data can be coded (packed) into a 
reduced character set. 


The data packing scheme is specified by the BPACK- 
ING command. 


BTIMEOUT 


When the terminal sends a block of data, it waits for a 
response from the host to acknowledge that it has 
received that block intact. If the terminal does not 
receive the appropriate response within a period of 
time or if it receives an erroneous response the 
terminal retransmits that block. It pauses again, and 
will repeat the sending of the block until it is acknowl- 
edged. 


The period of time the terminal waits before sending 
the block again is specified by the BTIMEOUT 
command. 


Be sure that the specified timeout period is longer than 
may be encountered due simply to a busy host. 
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BNONXMTCHARS AND BMASTERCHARS 


There are several charactes which cannot be transmit- 
ted in Block mode. ; 


For example, if A" is the block end character, it cannot 
be transmitted as an “A,” since whenever the terminal 
or host sees “A,” it assumes it indicates the end of a 
block. 


Therefore, whenever “A” or any other restricted char- 
acter must be sent, the terminal or host instead sends a 
master character, followed by a substitute character. 
When that two-character combination is received, it is 
decoded into the intended character. 


This is done automatically by the terminal and host. 
However, all non-transmittable characters must be 
specified by the BNONXMTCHARS command. The 
character used as the master character is specified by 
the BMASTERCHARS command. 


REV. AUG 1981 5-7 


COMMUNICATIONS 


HALF DUPLEX MODE 


The standard mode of communication is full duplex, All of the standard communications commands are 

including when the terminal is in Prompt mode or Block meaningful in half duplex mode. 

mode. In full duplex, the terminal and host can both 

send and receive data at the same time. in half duplex with Supervisor Communicatons mode, 
the host always controls the flow of data. That is, the 

in half duplex, either the terminal and host send data, host decides when the terminal or host sends or 

but not at the same time. receives data. 
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Section 6 


SETUP COMMAND DICTIONARY 


This section contains a detailed explanation of Setup 
mode and of each setup command. Table 6-1 provides 
an overview of the setup commands in a functional 
organization. The rest of this section is a detailed 
explanation of each command, in alphabetical order. 


To put the terminal into Setup mode, press the key 
labeled SET UP (Figure 6-1). The terminal must be in 
Setup mode to execute setup commands. 


Setup commands allow you to establish the terminal's 
operating environment and to use peripherals attached 
to the terminal. For example, setup commands are used 
for establishing communicatons rates, inquiring about 
the terminal’s status, determining what levels of errors 
the terminal should display, and programming special 
meanings (macros) into keys. 


SETUP COMMAND FORMAT 


A setup command starts with a command word, usually 
has one or more parameters, and ends with a carriage 
return, 


The “command word” is a descriptive English-like word 
indicating what the command does. A command word 
can be entered in either upper or lower case; it can be 
spelled out completely or abbreviated to as few 
characters as are necessary to distinguish it from other 
command words — usually two or three characters. 
Whatever amount of the command word is typed must 
be spelled correctly or an error results. 


In most cases a command includes one or more of six 
different parameter types. (Parameters are explained in 
more detail with the individual commands.) The param- 
eter types are: 


single characters 
keywords 
delimited character strings 


e 
e 
e 
® un-delimited character strings 
@ key specifiers 

e 


integers 


SET UP 
KEY 
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Figure 6-1. The SET UP Key. 
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Keyword parameters can be abbreviated to as few 
characters as are required to distinguish them from 
other keywords in the same command. 


A "key specifier’ parameter can be entered by press- 
ing the appropriate alphanumeric key or by entering its 
ADE (ASCII Decimal! Equivalent) value. 


A carriage return terminates a line and causes the 
command on that line to execute. One setup command 
can be entered per line. 


A “tine” can be up to 130 characters long. If you 
continue typing when the cursor is at the right edge of 
the screen or dialog area, the cursor wraps around to 
the left margin of the next line on the screen. It is still 
the same line until you enter a carriage return. If you 
continue to type after you reach the maximum of 130 
characters, the terminal bell rings each time you press 
any key except RETURN, the ‘character delete” key, or 


the “line delete” key (see the EDITCHARS command 
later in this section). 


CORRECTING A MISTAKE IN 
SETUP MODE 


You can backspace to edit one or more characters ona 
particular line by pressing the “character delete” key. 
You can discontinue the current line and start a new 
line by pressing the “line edit” key (see the ED- 
ITCHARS command later in this section for details). 


If you enter a carriage return to terminate a command 
and there is a mistake in the command just entered, an 
error message is displayed on the next line. When this 
happens, you can look up the meaning of the error 
message in Appendix A and reenter the command 
correctly. 


SETUP MEMORY 


The terminal stores many setup command parameters 
in “setup memory.” When the terminal is turned on, it 

remembers the parameters which are stored in setup 

memory. 


In Table 6-1, command names preceded by a 
superscript are stored in setup memory. In the explana- 


tions of the commands, ‘‘(Memory)" is printed immedi- 


ately following the statement of the purpose of the 
command, to indicate that the command's parameters 
are saved in setup memory. 


You can use the STATUS command to determine 
current status of the terminal or a particular parameter, 
as explained later in this section. 


HOW SETUP INTERACTS WITH OTHER FUNCTIONS AND MODES 


Host Communications. Communication to the host is 
suspended when the terminal is in Setup mode. Data 
sent from the host to the terminal is stored in a queue 
in the terminal during Setup mode and processed when 
the terminal exits from Setup mode. (The size of the 
input queue is determined by the QUEUESIZE setup 
command) 


GIN Mode. When the terminal enters Setup mode, GIN 
mode is suspended. The GIN cursor disappears and 
graphics input data is not communicated. When you 
exit from Setup mode, the cursor reappears and GIN 
mode continues. Graphics input is explained in Section 
4. Also see the 4112 Host Programmer's Reference 
Manual and the 4110 Series Command Reference 
Manual. 
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Control Characters. If you enter a control character 
when the terminal is in Setup mode, the control 
character is displayed rather than executed. Control 
characters are displayed in a coded two character 
abbreviation called snoopy” characters. 


Programmed Keys. If the terminal is in Setup mode 
and you press a key which has a macro programmed 
into it (see DEFINE, later in this section), the macro is 
expanded as usual. 


Local Mode. When the terminal is in both Setup and 
Local modes at the same time, Setup mode takes 
priority. 
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ESCAPE SEQUENCE COMMANDS 


Setup commands are a subset of the terminal’s com- 
mand repetoire. Setup commands are those which are 
used most often and which an operator will find most 
useful. Setup mode also allows you to execute 


commands for which there is not an English-like 
command word. These are called “escape sequences,” 
since the first character of these commands is the 
“escape” character. (See Appendix C.) 


COMMAND SYNTAX CONVENTIONS 


Figure 6-2 illustrates the format used in presenting the 
syntax of the terminal's setup commands. 


The beginning of the explanation of each command is 
at the top of a column. The column’s heading is the 
command name. Immediately after the command name 
is a brief explanation of the purpose of that command. 
Following that, the word “(Memory)” appears if the 
command’s parameters are saved in setup memory, 
and the option number if this command is part of a 
terminal option. 


The next line shows the command in its correct syntax, 
according to the following conventions: 


@ The command name is shown first, in all capital 
letters, and bold faced type. You can enter the 
command name in lower case if you prefer, and can 
abbreviate the command name to as few characters 
as are necessary to distinguish it from other com- 
mands. 


@ Words that must be entered as shown, such as 
command names and keywords, are shown in bold 
faced type. 


@ Parameters in regular faced type are descriptive of 
the kind of information that parameter specifies. 


@ Each parameter is separated by one or more spaces 
or a comma. You can separate by one comma anda 
space or by multiple spaces. Multiple commas have 
a special meaning. 
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@ Parameters in square brackets are optional. 


@ You must choose one parameter when two or more 
are stacked and in curly brackets. 


@ You may choose one parameter when two or more 
are stacked within square brackets. 


@ When you can choose between a number of different 
variations, the presentation of the syntax is simpli- 
fied by showing it in two or more statements. 


COMMAND parameter, [parameter], ‘parameter } 
[parameter], / parameter | 


parameter explanation.... 
parameter explanation.... 
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Figure 6-2. Format of Setup Command Syntax. 
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SETUP COMMAND SUMMARY 


Table 6-1 lists and briefly describes all setup com- 
mands. It also indicates the factory default parameters, 
which commands are part of options to the terminal, 
and those commands whose parameters are stored in 
setup memory. The factory default is shown for each 
parameter because that is what the terminal defaults to 
if the setup memory fails, or is changed by the addition 
or deletion of a circuit board. 


Table 6-1 


NOTE 


In this table, the information in parenthesis 
AFTER the commands indicates the following: 


01= Extended Communications option 
10= Three Port Peripheral Interface option 
13/14= Graphics Tablet options 

42= Flexible Disk option 


SETUP COMMANDS 


Function 


ee 


aCRLF 


General Terminal 
Operation 


®REOM 


ARLINELENGTH 
SNOOPY 
STATUS 


4S aved in Setup Mamory. 
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Factory 
Default 


Purpose 


Sets or terminates “carriage return implies 
line feed.” 


aECHO No Sets local or remote echo. 
SEDITCHARS RUB- Defines character delete, line edit, and 
OUT, nN, ~ “literal” characters. 

@ERRORLEVEL 2 Sets error reporting threshold. 

8FIXUP 6 Determines how thoroughly the viewport is 
updated when a change is made that 
affects it. 

aGAMODE Replace Determines if background of character is 
visible when text is displayed in graphics 
area. 

§GRIDDING Establishes an invisible grid on the screen 
for GIN mode. 

alGNOREDEL No Specifies whether or not the “delete” 
character is ignored. 

4LFCR No Sets or terminates “line feed implies car- 
riage return.” 

@aPAGEFULL None Determines action to be taken when page 
full condition occurs. 

aPICKAPERTURE 8 Determines size of aperture used for pick- 


ing function. 


Determines use of end of message 
character for GIN mode. 


Determines GIN report line length limit. 
Sets or terminates “snoopy” mode. 


Displays the terminal's status. 
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Function 


Dialog area 
control 


Keyboard control 


Data transfer 
control 


Flexible disk 
control 


*DAENABLE 


§8DAINDEX 


®DALINES 


®DAMODE 


§DAPOSITION 


aDASURFACE 


DAVIS 

DEFINE 
®KEYEXCHAR 
LOCKKEY BOARD 


COPY 
LOAD 


MAPINDEX 
PCOPY(10) 


PLOT(10} 


SAVE 


SPOOL 


DELETE(42) 
DIRECTORY (42) 
FORMAT (42) 


PROTECT (42) 


RENAME (42) 


"Saved in Setup Memory. 
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SETUP COMMANDS 


Command Factory 
Default 


®DABUFFER 
aDACHARS 


15 
80 


No 


7,0, 0 


Replace 
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Purpose 


Sets maximum size of dialog buffer in lines. 


Sets maximum number of characters per 
line in the dialog area. 


Specifies whether or not alpha text is sent 
to the dialog area. 


Specifies the gray-scale index in the dialog 
area. 


Specifies the visible portion of the dialog 
buffer. 


Sets Overwrite or Replace mode in dialog 
area. 


Sets position of dialog area. 


Sets dialog area surface. 


Sets visibility of the dialog area. 
Assigns macro to key or integer. 
Specifies the key execute toggle character. 


Locks the keyboard. 


Copies data from one device to another. 


Reads a file and executes it as a command 
file. 


Assigns a gray-scale index to a plotter pen. 


Copies between peripheral devices and the 
host. 


Plots currently visible segments to speci- 
fied device. 


Saves macro, segment, text font, or pixels 
to a disk file. 


Copies data from one device to another, 
leaving the terminal free to do other jobs at 
the same time. 


Halts the spooling operation. 


Deletes a file from the disk. 
Displays a directory of the disk. 


Prepares a disk so files can be created on 
it. 


Prevents the the terminal from writing toa 
disk or to a specific disk file. 


Renames a disk file. 
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Function 


Three port 
peripheral 
interface control 


Standard 
Communications 


PASSIGN(10) 
§PBAUD(10) 
@PBITS(10) 
§®PEOF(10) 
®PEOL(10) 
@PFLAG(10) 
STATUS(10) 
4PPARITY(10) 


*BAUDRATE 


*BREAKTIME 


®BYPASSCANCEL 
3EOFSTRING 
aEOLSTRING 
3EOMCHARS 
®FLAGGING 


®PARITY 


®PROMPTMODE 


SPROMPTSTRING 


SQUEVUESIZE 


8STOPBITS 


®XMTDELAY 


®XMTLIMIT 


8Saved in Setup Memory. 
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SETUP COMMANDS 


. Default 


2400 


2400, 2400 
200 
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Purpose 


Assigns a device to a port. 

Sets baud rate for a port. 

Sets the stop and data bits for a port. 
Defines the end of file string for a port. 
Defines the end of line string for a port. 
Establishes type of flagging for a port. 
Returns status on specified port. 


Establishes the parity checking used ona 
port. 


Sets transmit and receive baud rates. 


Defines length of break transmission in 
milliseconds. 


Sets bypass cancel character. 
Defines end of file string. 

Defines end of line string. 

Defines end of message characters. 


Specifies kind of flagging done by the 
terminal. 


Specifies the kind of parity sent from the 
terminal. 


Specifies whether or not the terminal is in 
Prompt mode. 


Specifies prompt used when terminal is in 
Prompt mode. 


Sets size of terminal input queue. 


Specifies number of stop bits the terminal 
uses. 


Specifies length of time termina! waits after 
receiving end of message character. 


Specifies maximum transmit rate for the 
terminal. 
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Table 6-1 (cont) 
SETUP COMMANDS 


Command Factory 
Default 


3BCONTINUECHARS(01) 


Function Purpose 


Optional & & Specifies block continue characters. 


Communications 


®BENDCHARS(01) $ $ 


@BHEADERS(01) "HEADTX’ 
"HEADRX’ 


aBLENGTH(01) 256 256 
@BLINELENGTH(01) 70 


Specifies end of block characters. 


Specifies block header sequences. 


Specifies block length. 


Specifies line length for Block mode 
transmission. 


§8BLOCKMODE(01) No Specifies whether or not terminal is armed 


for Block mode. 


®8BMASTERCHARS(01) # # Specifies master characters for Block 


mode. 


@8BNONXMTCHARS(01) ‘#$8&' '#S8' Specifies non transmittable characters for 


Block mode. 


@BPACKING(01) 7, 6, 7, 6 Specifies manner in which blocks are 


packed. 


aBTIMEOQUT(O1) 0 Specifies how long terminal waits before 


retransmitting previous block of data. 


®DUPLEX(01) Specifies which Duplex mode the terminal 


is in. 


aT BFILTER(13/1 4) 
®TBHEADERCHARS (13/1 4) 
TBSTATUS(1 3/14) 


Graphic Tablet Specifies tablet data filtering. 


LETTERS Specifies tablet stroke header characters. 


IN Specifies if status byte is sent when input 


device is lifted from tablet surface. 


®8Saved in Setup Memory. 
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BAUDRATE NOTE 

Specifies the transmitting and receiving baudrates for The terminal's baud rate settings must be com- 
communications between the terminal and the host patible with the transmit and receive baud rates 
computer. used by the host computer. 

(Memory) 


The transmit and receive rates do not have to be set to 
BAUDRATE trans, rec the same values. Also, either the transmit or receive- 
—<$<—$<—<———SS SS rate can be specified by an external clock while the 
other is specified by the terminal firmware. 


trans is an integer parameter specifying the baud 

rate at which the terminal transmits data. Valid 
baud rates are the same as those listed for “rec.” 
A value of 1 indicates the use of an external 
device to control the transmission rate. The 
factory default baud rate is 2400. 


The following command sets the transmit rate at 9600 
baud and the receive rate at 2400 baud. 


BAUDRATE 9600, 2400 ‘°r 
The following command sets the transmit baud rate to 


2400 while the receive baud rate is controlled by an 
external clock. 


BAUDRATE 2400 1 ‘Sr 


rec is an integer parameter specifying the baud 
rate at which the terminal expects to receive data 
from the host. A value of 1 indicates external 
clocking. Valid specifications for “trans” and 
“rec” are listed. If you enter no value for “rec,” it 
is set to the same value as “trans.” The factory 
default is 2400. 


The baud rate parameter may be set for you by an 
initialization file on a flexible disk. If it is not, you may 
need to consult with a system programmer for your 
Valid baud rates are: host computer before using this command. 
50 
75 
110 
134 (sets baud rate to 134.5) 
150 
300 
600 
1200 
1800 
2000 
2400 
4800 
9600 
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BCONTINUECHARS 


Sets the line continue characters. for block mode. 
(Memory) 


(Option 01) 


BCONTINUECHARS xmt, rec 


xmt is a single character representing the trans- 

mit continue character. If you do not enter a value 
for ‘xmt" it is set to null. Any ASCII character is 
valid; the factory default is an ampersand (&). 


rev is an single character representing the re- 
ceive block continue character. If you do not 
enter a value for “rev” it is set to null. Any ASCII 
character is valid; the factory default is an 

E ampersand (&). 


This command cannot be used if the terminal is already 
in or armed for Block mode. See the BLOCKMODE 
command. 


If you enter just the command word and no parameters, 
both “xmt” and “rcv” are set to null. 


The terminal sends the ‘'xmt” character to the host to 
indicate when a block continues to the next line. When 
the terminal receives the “rcv” block continue 
character, the terminal knows that the block it is 
receiving continues to the next line. 


The following command specifies the percent (%) as 
the transmit block continue character and the asterisk 
(*) as the receive block continue character: 


BCONTINUECHARS % * Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BENDCHARS 


Sets the block end characters for Block mode. 
(Memory) 


(Option 01) 


BENDCHARS xmt, rcv 


xmt is a single character representing the trans- 
mit block end character. If you do not enter a 
value for “xmt”’ it is set to null. Any ASCII 
character is valid; the factory default is the dollar 
sign ($). 


rev is a Single character representing the receive 
block end character. If you do not enter a value 
for “rcv” it is set to null. Any ASCII character is 
valid; the factory default is the dollar sign ($). 


This command cannot be used It the terminal |s alreaay 
armed for Block mode. See the BLOCKMODE com- 
mand. 


If you enter just the command word and no parameters, 
both 'xmt” and “rcv” are set to null. 


The terminal transmits the “xmt’ character to the host 
to indicate the last line of a transmission in Block 
mode. When the terminal receives the ‘‘rcv’”’ character, 
the terminal knows that it is the last line of a block 
transmission. 


The following command sets the block end transmit 
character to the pound sign (#) and the block end 
receive character to the ampersand (&): 


BENDCHARS # & Snr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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SETUP COMMANDS 


BHEADERS 


Sets the transmit and receive header sequences for 
Block mode. 
(Memory) 


(Option 01) 


BHEADERS rxmt?L, rcv 
D_ is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, or edit character (see EDITCHARS) is the 
delimiter character for this command. 


xmt is a delimited character string representing 
the transmit block header sequence. Any string of 
up to ten ASCII characters can be used (restric- 
tions are listed under “rcv”). The factory defauit 
“xmt'’ header is HEADTX. 


rev is a delimited character string representing 
the receive block header sequence. The factory 


default “rcv” header is HEADRX; “rcv” is set to 
null if no string is specified. Any string of up to 
ten ASCII characters can be used with the 
following restrictions: 


@ the first character cannot be repeated in the 
sequence. 


@ the sequence cannot include any characters 
which are part of the prompt string (see 
PROMPTSTRING). 


@ the sequence should be one that would never 
appear in normal text. 


This command cannot be used if the terminal is already 
in or armed for Block mode. See the BLOCKMODE 
command. 


If you enter just the command word and no parameters, 
both “xmt" and “rcv” are set to null. 


When the terminal sends the 'xmt" sequence, it signals 
the host that a block of packed data follows immediate- 
ly. When the terminal receives the rcv" sequence, it 
signals the terminal that a block of packed data follows 
immediately. 


The following command sets the transmit block header 
to ‘+ send” and the receive block header to ‘'+ recve’’: 


BHEADERS /+send/ /+recve/ Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization fileona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BLENGTH 


Sets the block length for Block mode. 
(Memory) 


(Option 01) 


BLENGTH xmt, rev 


xmt is an integer parameter representing the 
transmit block length. The valid range of values is 
from five to 65535 lines. The factory default is 
256. 


rev is an integer parameter which is the receive 
block length value. The values range from five to 
65535 lines. The factory default is 256. 


This command cannot be used if the terminal is already 
armed for block mode. See the BLOCKMODE com- 
mand. 


The following command sets the block length to 100: 
BLENGTH 100 Cr 

This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 


system programmer for your host computer before 
using this command. 
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BLINELENGTH (Option 01) 


Specifies the maximum length line that the terminal will 
transmit in Block mode. 
(Memory) 


BLINELENGTH length 


iength is an integer parameter specifying the 
maximum number of characters the terminal can 


transmit in one line in Block mode. The valid 
range is from 12 to 65535 characters. The factory 
default is 70 characters. 


This command cannot be used if the terminal is already 
armed for Block mode. See the BLOCKMODE com- 
mand. 


The specified line length has no effect on input to the 
terminal for communications in non-Block mode. 


The following command sets the line length to 55: 
BLINELENGTH 55 Cr 

This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 


system programmer for your host computer before 
using this command. 
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BLOCKMODE 


Specifies that the terminal will go into Block mode as 
soon as it receives a block header. 
(Memory) 


(Option 01) 


BLOCKMODE (yes! 
tno} 


yes is a keyword parameter specifying that the 
terminal should enter Block mode when it 
receives the next block header (see BHEADER). If 
you enter just the command word and no parame- 
ter, the terminal assumes “yes” and arms itself 
for Block mode. 


no is a keyword parameter specifying that the 
terminal is not in Block mode. If the terminal is in 
Block mode when you enter this command, it 
exits from Block mode immediately. This is the 
factory default. 


Attempting to arm the terminal for Block mode when it 
is already in Block mode will cause communications 
difficulties with the host computer. 


The following command causes the terminal to enter 
Block mode: 


BLOCKMODE yes Cnr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BMASTERCHARS (Option 01) 


Sets the master characters for Block mode. 
(Memory) 


BMASTERCHARS xmt. rec 


| xmt is a single character the transmit “master | 
character” for block mode. If you do not enter a 


value for “xmt" it is set to null. Any ASCil 
character is valid; the factory default is the pound 
sign (#). 


rcv is a single character representing the receive 
“master character” for Block mode. If you do not 
enter a value for “rcv” it is set to null. Any ASCII 
character is valid; the factory default is the pound 
sign (#). 


This command cannot be used if the terminal is already 
armed for Block mode. See the BLOCKMODE com- 
mand. 


If you enter just the command word and no parameters, 
both “xmt” and “rev” are set to null. 


The foilowing command sets the transmit master 
character to an asterisk (*) and the receive master 
characer to a dollar sign ($): 


BMASTERCHARS * $ Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BNONXMTCHARS 


Sets the non-transmittable characters for Biock mode. 
(Memory) 


(Option 01) 


BNONXMTCHARS xmt®L, Srev?L 


D. is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, or edit character (see EDITCHARS) is the 
delimiter character for this command. 


xmt is a string of up to 20 ASCIi characters 
representing the non-transmittable characters in 


Block mode. The factory default string is the 
pound sign, dollar sign and ampersand (‘#$&’). 


rev is a string of up to 20 ASCil characters 
representing the non-receivable characters in 
Block mode. The factory default string is the 
pound sign, dollar sign, and ampersand (#$&'), 


This command cannot be used if the terminal is already 
armed for Block mode. See the BLOCKMODE com- 
mand. 


If you enter just the command word with no string for 
either “xmt” or “rev,” both are set to null. 


A character is to be ‘“‘non-transmittable” because it has 
a special meaning to the terminal (such as the block 
continue, block end, or block master characters) or 
host. 


The following command sets the plus sign (+) and per 
cent sign (%) as non-transmittable characters for both 
transmitting and receiving: 


BNONXMTCHARS ‘'+&' ‘'+&' Cr 


These characters may be set by an applications 
program on the host computer or by an initialization file 
on a flexible disk. If it is not, you may need to consult 
with a system programmer for your host computer 
before using this command. 
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BPACKING (Option 01) 


Sets the transmitting and receiving packing values for 
Block mode. 
(Memory) 


BPACKING xmt, xmtpack, rcv, rcvpack 


xmt must be set to either 7 or 8 bits. It specifies 
the size of each byte that is transmitted. The 
factory default is 7 bits. 


xmtpack must be set to 6, 7, or 8. It specifies the 
number of effective data bits per word that is 
transmitted. The factory default is 6. 


rcv must be set to either 7 or 8. It specifies the 
size of each byte received from the host. The 
factory default is 7. 


revpack must be set to 6, 7, or 8. it specifies the 
number of effective data bits per word that is 
received. The factory default is 6. 


This command cannot be used if the terminal is already 
armed for Block mode. See the BLOCKMODE 
command. 


The following command sets the “xmt” value to 8, the 
“xmtpack” value to 7, the “rcv” value to 8, and the 
“revpack” value to 7: 


BPACKING 8 7 8 7 Sr 


These parameters may be set by an applications 
program on the host computer or by an initialization file 
ona flexible disk (see Section 3). If it is not, you may 
need to consult with a system programmer for your 
host computer before using this command. 
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BREAKTIME 


Specifies the length of the break transmission. 
(Memory) 


BREAKTIME ms 


ms is an integer parameter specifying the length 
of the interrupt, in milliseconds. The valid range is 
from 0 to 65535. The factory default is 200 ms. 


Setting ‘ms’ to 0 means that no break transmis- 
sion is sent. If you do not enter any value for the 
parameter, it is set to zero. 


When you press the BREAK key, an interrupt is sent by 
the terminal to the host. The purpose of the interupt is 
to halt execution of a host resident program or 
transmission of data from the host. 


Different host computers must receive an interrupt for 
different amounts of time to recognize it and break off 
the transmission. The length of the interrupt is deter- 

mined by the BREAKTIME command. 


The following command sets the interrupt time to 400 
ms. 


BREAKTIME 400 Cr 


Since the interrupt is handled differently by different 
hosts, you should check with a system programmer for 
your host before using the BREAKTIME command or 
the BREAK key. 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk (see Section 3). If it is not, you may need 
to consult with a system programmer for your host 
computer before using this command. 
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BTIMEOUT (Option 01) 


Determines how long the terminal will wait for a 
response from the host before retransmitting the 
previous block. 

(Memory) 


BTIMEOUT seconds 


seconds is an integer parameter specifying the 
number of seconds the terminal will wait before it 
retransmits a block of data. Valid values are from 
0 to 65535; a setting of 0 disables the feature. If 
you do not enter a value for the parameter, it is 
set to zero. The factor default is zero. 


If the setting is too jong, you would have to wait a long 
time to become aware that there was a problem such 
as a block being lost. If it is too short, the terminal 
might try to send a block again just because the host 
was slow to respond. Setting it to zero disables the 
timeout feature. 


The following command sets the “time out" to 2 
seconds: 


BTIMEOUT 2 Cnr 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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BYPASSCANCEL 


Specifies the bypass cancel character. 
(Memory) 


BYPASSCANCEL char 


char is an un-delimited single ASCII character. 
This parameter is usually set to either a ‘+ (line 
feed) or a Cn (carriage return). The factory default 


is the ‘re. If no character is specified the parame- 
ter is set to null and the bypass feature is turned 
off. 


Remote echo computers use Bypass mode to suppress 
the echoing of unnecessary control characters. The 
terminal uses the bypass cancel character to get out of 
Bypass mode. 


The following command sets the bypass cancel 
character to carriage return. The “tilda” above the first 
carriage return indicates that the carriage return was 
preceded by the literal character (see EDITCHARS). 


BYPASSCANCEL Cr Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk (see Section 3). If it is not, you may need 
to consult with a system programmer for your host 
computer before using this command. 
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COPY 

Copies data from one device to another. 

COPY {source} to {destination} 
(fitename} {filename} 


er is a device identifier indicating the loca- 
tion of the file to be copied. If no device is 
specified, the terminal defaults to the disk drive. 
Valid devices are: 


HO: host computer 

PO: peripheral port O 
P1: peripheral port 1 
P2: ‘peripheral port 2 


filename is an un-delimited character string. On 
the ‘‘source” side of the command (before the 
word “‘to’’), it identifies the name of the file to be 
copied. On the “destination” side of the command 
(after the word “to’), it identifies the name of the 
file into which the copy is to be made. Only use a 
filename when the file (either source or destina- 
tion) is on a disk drive. 


to is a keyword parameter which helps you 
remember the flow flow of the copy — from the 
source to the destination. 


destination is a device identifier indicating the 
location to which a copy is to be made. The 
terminal defaults the disk drive if no device is 
specified. Valid device indentifiers are the same 
as for “source.” 


The copy operation continues until: 


® an “end of file” string (EOF) is encountered 

@® you press the CANCEL key 

@ an error is detected 

An error can be caused by many factors. For example, 


if the destination device is a disk drive an error can 
occur if: 


@ there is no disk in the destination drive 
@ the disk in the destination drive is write protected 


@ the destination drive is trying to write onto a bad 
disk area 


@ there isn't enough room on the destination disk to 
hold the entire output file 
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If a COPY is invoked in Setup mode and you enter 
anything from the terminal's keyboard during the copy, 
the first 130 characters are queued and executed 
when the COPY is finished. After you enter 130 
characters, the bell rings each time you press any key 
(except CANCEL). 


Before you copy a file to a disk you should make sure 
that there is enough room for the file. You can 
determine the length of an individual file as well as the 
room available on the destination disk with the DIREC- 
TORY command. 


You cannot copy to a file or disk that is write protected. 
A disk can be write protected by the WRITE PROTECT 
switch (see Section 2) or by uncovering the notch in 
the disk (see Section 3). A file or disk can be write 
protected by the PROTECT setup command (described 
later in this section). 


If there is already a file on the destination disk by the 
name you specify and it is not write protected, the 
existing file will be replaced. If the existing file is write 
protected, the copy fails and an error message is 
displayed. 


The following command copies data from file A on the 
disk to file B on the disk: 

COPY AO: to B1: Sr 

This command copies ‘stuff’ from the disk to the 
output device attached to peripheral port 2: 

COPY stuff to P2: Cr 


Copying To and From the Host 


lf the source device is the host (HO:), you must begin 
the data transmission before you enter the COPY 
command from Setup mode. Once you enter the 
command, the terminal will wait for a data stream from 
the host until an end-of-file string comes from the host 
or until the CANCEL key is pressed. 


One way to arrange the data stream is: 


@ Type the command to the host to begin the data 
stream without the end-of-command character from 
outside of Setup mode. 


@ Enter Setup mode. 


@ Type in the COPY command with the desired 
destination. 
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© Exit Setup mode (after you press the SET UP key, 
the light in the key stays on, but data is being 
transmitted to the host). 


® Type the end-of-command character. If your host 
echos the character typed on the terminal, the above 
results in the end-of-command character being the 
first character in the data stream. 


Another way to do So is: 


® Program the host so that there is a delay between 
the time you enter the end-of-command character 
for the host-data-send command and the time the 
data stream begins to flow. If you use this method 
you should give yourself enough delay-time to enter 
Setup mode and type the COPY command with the 
desired destination. You may also want to use the 
QUEUESIZE command to create a large input queue. 


If you specify the host as destination, then be sure that 


the host is ready to accept data, or you may lose your 
data and/or cause problems with the host. 
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CRLF 


Specifies whether or not a carriage return character is 
interpreted as a carriage return ora carriage return- 
line feed. 


(Memory) 
CRLF yes} 
{no} 


yes is a keyword indicating that the terminal 
should attach a line feed character to each 
carriage return character. 


no is a keyword indicating that the terminal 
should not attach a line feed character to the 
carriage return. This is the factory default. 


A carriage return moves the cursor back to the left 
margin of the current line; a line feed moves the cursor 
down one line from its current position. 


The following command causes the terminal to attach 
the line feed character to the carriage return: 


CRLF yes Cnr 


if you set the parameter to “yes” and the host 
automatically sends a line feed character with the 
carriage return, the terminal “double spaces” each time 
you press the RETURN key because it is getting a line 
feed from the host and from the terminal. 


\f the terminal is in Local mode, pressing the RETURN 
key only returns the cursor to the left margin of the 
current line. You must press the LINE FEED key to 
move to the next line or set CRLF to “yes” so that the 
RETURN key echoes a carriage return line feed 
combination. 


When the terminal is in Setup mode, pressing the 


RETURN key always gives the carriage return-line feed 
combination regardless of the CRLF specification. 
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DABUFFER 


Specifies the total size of the dialog buffer. 
(Memory) 


DABUFFER lines 


lines is an integer parameter which specifies the 


size of the dialog buffer. The minimum dialog 
buffer size is two; the factory default is 15. 


A change in the dialog's buffer size becomes effective 
the next time the dialog area becomes visible. 


The maximum dialog buffer depends on the amount of 
available memory. If you specify a dialog buffer larger 
than the currently available memory, it is set to the 
maximum currently available memory. If more memory 
becomes available later, the size of the dialog buffer is 
increased accordingly. 


If the buffer is full when a fine of text is received, the 
first line is deleted to make room for a new line at the 
end. 


The following command increases the dialog buffer so 
it will hold 30 lines of data: 


DABUFFER 30 Cr 


If you change the size of the scroll buffer, the 
information in the dialog area is not lost or changed, 
unless the size is reduced. In that case, the most 
recent dialog is maintained in the buffer. The new size 
takes affect the next time the dialog area becomes 
visible. 
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DACHARS 


Specifies the maximum number of characters per line 
in the dialog buffer. 
(Memory) 


DACHARS width 


width is an integer parameter indicating the 
maximum number of characters per line. The 
factory default is 80. The minimum width allowed 


is 5; the maximum number of characters allowed 
per line is 80. 


It you specify more than 80 characters per line, the 
terminal reports an error. If you specify more 
characters than fit due to the current dialog area 
position, the dialog area is moved to allow the specified 
width. The following “warning” is displayed the next 
time the dialog area becomes visible (you will not see 
the warning if the terminal's error reporting mechanism 
is set to Suppress warnings): 


>> Terminal Issues Message LV@3: 
22 Dialog Parameters Modified. 


The terminal remembers the width you specified and if 
the dialog area position is changed, the width parame- 
ter is automatically changed accordingly. 


If you change the width, information in the dialog area 
is not lost. The new width takes effect the next time the 
dialog area is visible, and when the next text is 
received in the dialog area. 


The following command changes the maximum width of 
each line in the dialog area to 35: 


DACHARS 35 Sn 
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DAENABLE 


Enables or disables the dialog area. 
(Memory) 


DAENABLE yes} 


yes is a keyword parameter which enables the 
dialog area. If you do not specify “yes” or “no,” 
the parameter is set to ‘‘yes.” 


no is a keyword parameter which disables the 
dialog area. This is the factory default. 


When the dialog area is enabled, all alpha (non 
graphics) text is directed to it. The dialog area itself is 
made visible by a separate command (see the DIALOG 
key in Section 2 and the DAVIS command in this 
section). If the dialog area is enabled when you turn the 
terminal on, the dialog area will automatically be 
visible. 


When the dialog area is not enabled, alpha text is 
directed to the graphics area of the screen. If the dialog 
area is visible but not enabled, you can see text written 
in the dialog area before it was disabled but the 
subsequent text will not go into the dialog area. 


When the dialog area is enabled, pressing the RETURN 
key does not cause the terminal to exit from Vector, 
Marker, or 4010-style GIN mode. If you are in one of 
those modes at the end of a program, press the 
CANCEL key to return the terminal to Alpha mode. 


The following command enables the dialog area: 
DAENABLE Cr 
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DAINDEX 


Specifies gray indices in the dialog area. 
(Memory) 


DAINDEX character, background, wipe 


character is an integer parameter specifying the 
gray index of text in the dialog area. For all three 
parameters, the lower the integer, the darker the 


gray index. The factory default for the “character” 
parameter is white. 


background is an integer parameter specifying 
the gray index of the part of the character cell in 
which the character is not drawn. The factory 
default is black. 


wipe is an integer parameter specifying the gray 
index of the dialog area when it is wiped (erased). 
The factory default is black. 


The indices you can use depend on the number of 
planes your terminal has access to. Without any option, 
your 4112 has one plane (0 is black and 1 is white). If 
your terminal has the three-bit plane option there are 
three planes (0 is black and 7 is white). 


When you change a dialog area index, it is effective the 
next time the dialog area is made visible. 


Note that if you were to set ail three indices to 0, the 
dialog area would be invisible because you would have 
black characters and black character cells on a black 
background. Text in the dialog area would also be 
invisible if you set all three indices to 7 since you 
would have white characters and character cells ona 
white background. 


lf you enter just the command and no parameters, all 
three indices are set to O causing the dialog area to 
become invisible the next time it is turned on. 
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DALINES 


Specifies the number of lines of the dialog buffer 
displayed on the screen. 
(Memory) 


DALINES lines 


lines is an integer parameter, specifying the 
number of lines in the dialog buffer which are to 


be visible. The factory default is five. The valid 
range is from 2 to 34. 


If you specify more visible lines than the current dialog 
area position allows, the terminal automatically 
changes the position to allow the specified number of 
lines. In that case the following warning is displayed 
the next time the dialog area becomes visible (you will 
not see this warning if the terminal's error reporting 
mechanism is set to suppress warnings): 


>> Terminal Issues Message LV@3: 
ee: Dialog Parameters Modified. 


If you change the number of visible lines, the informa- 
tion in the dialog buffer is not changed or lost. The 
change is effective the next time the dialog area is 
made visible (see DAVIS). 


The following command causes 15 lines of the dialog 
buffer to be displayed at a time: 


DALINES 15 Cr 
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DAMODE 


Specifies the manner in which characters in the dialog 
area are replaced. 
(Memory) 


DAMODE replace} 
toverstrike} 


replace is a keyword meaning that the character 
is erased as you backspace over it. This is the 
factory default. 


overstrike is a keyword meaning that the charac- 
ter is not erased as you backspace over it. 


If you change the setting of DAMODE, it is effective the 
next time the dialog area becomes visible. 


The following command changes the DAMODE setting 
to overstrike: 


DAMODE overstrike Cr 
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DAPOSITION 


Specifies the location of the lower left corner of the 
dialog area. 
(Memory) 


DAPOSITION x, y 


x is an integer parameter specifying the X-axis 
coordinate of the lower left corner of the dialog 
area. 


y is an integer parameter specifying the the Y- 
axis coordinate of the lower left corner of the 
dialog area. 


Figure 6-3 illustrates the limits of the screen coordi- 
nate system for this command. 


The terminal will not allow you to position the dialog 
area off the screen. An error results if you enter “x” or 
“y" coordinates that are not within the extents shown 
in Figure 6-3. The position is automatically adjusted if 
the current DACHARS and DALINES settings would not 
fit in the specified position. The terminal remembers 
the specified location and if the line width or number of 
visible lines is changed, the location of the dialog area 
is automatically changed appropriately. 


If the dialog area position is modified, the following 
warning is displayed the next time the dialog area 
becomes visible (you will not see the warning if the 
terminal's error reporting mechanism is set to suppress 
warnings): 


>> Terminal Issues Message LV@3: 
»> Dialog Parameters Modified. 


If you change the position of the dialog area 
information already in the dialog area is not lost. It 
appears at its new position the next time the dialog 
area is made visible (see DAVIS). 


The following command moves the lower left corner of 
the dialog area near the center of the screen (if 
DACHARS is set to 40 or more or if DALINES is set to 
17 or more, the terminal adjusts the actual! position): 


DAPOSITION 2049, 1561 Cr 
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DASURFACE 


Specifies screen surface on which dialog area is to 
appear. 
(Memory) 


DASURFACE surface 


— 
surface specifies the screen surface on which 
the dialog should appear. Valid surface values are 
1 (the front surface), 2, and 3 (the back surface). 
The factory default is 1. Your terminal should 
have the three bit plane memory (Option 20) to 
use surfaces 2 and 3. 


Putting the dialog area and graphics on different 
surface allows you to have a visible dialog area and 
still use the full screen for graphics. However, graphics 
on a Surface in front of the dialog area obscures the 
portion of the dialog area where the two overlap. 


Before DASURFACE is efective, surfaces must be 
defined for the terminal. There is no setup command for 
doing so. See the < set-surfaces-definition> com- 
mand in the 4110 Series Command Reference Manual 
for information. 
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DAVIS 


Specifies whether or not the dialog area is visible. 


DAVIS {yes} 
{no} 


yes is a keyword specifying that the dialog area 
should be visible. This is the power up and reset 
default if the dialog area is enabled. If you do not 
enter “yes” or “no,” the terminal defaults to “yes.” 


no is a keyword specifying that the dialog area 
should not be visible. This is the power up and 
reset default if the dialog area is not enabled. 


Entering this command has the same effect as pressing 
the DIALOG key. When you use DAVIS to make the 
dialog area visible, the light in the DIALOG key turns 
on. The light turns off when you use DAVIS to make the 
dialog area not visible. 


If the dialog area is enabled when the terminal is 
turned on, the dialog area is automatically visible. 


When you enter the command, it takes effect immedi- 
ately. 
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You can use the DAVIS command to update the dialog 
area if you change any of its attributes. For example, if 
you change the dialog area’s position and the number 
of visible lines, you can enter the following command to 
make the changes effective: 


DAVIS rR 
Even though the dialog area may already be visible, 


this command updates it as though the dialog area 
were turned off and back on again. 


x 


4095,4095 


Figure 6-3. DAPOSITION Extents. 
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DEFINE 


Defines a macro and associates it with a key or an 
integer. 


DEFINE [key] 
fall] 
DEFINE key, "macro. 
DEFINE key, °.macro [ “Ke macro Xe] 


key specifies the key or integer with which this 
macro is to be associated. If the command is 
terminated after this parameter, the macro asso- 
ciated with the specified key or integer is deleted. 


all is a keyword indicating that all existing 
macros should be deleted. 


D1. is the delimiter character. You can use any 
ASCIl character to delimit the macro except: 


a comma 
a space 

the “character delete” character (see 
EDITCHARS) 

the “line delete” character (see EDITCHARS) 
the “literal” character (see EDITCHARS) 


The first character after the “Key” parameter that 
is not a Space, comma, or edit character is the 
delimiter for that macro. The delimiter should not 
occur in the macro itself, since the second use of 
the delimiter terminates the macro. The same 
delimiter must be used to terminate the macro. 


macro is the character or character string trans- 
mitted when you press the specified key or when 
the host executes the integer associated with the 
macro. The total length of the command 
(including the command word and macro) can be 
a maximum of 130 characters. If you want to 
include a “carriage return” or one of the edit 
characters in a macro, it must be preceded by the 
‘literal’ character — see the EDITCHARS com- 
mand. 


Ke is the “key execute delimiter’ character. When 
this character appears in a macro, it changes the 
direction of the macro expansion. If it was being 
expanded to the host, the key execute delimiter 
causes it instead to be expanded to the terminal; 

if the terminal had been receiving the macro it is 
subsequently sent to the host. The expansion of a 
subsequent macro starts in the same direction as 
when the last macro ended. The “key execute 

| delimiter” is defined by the KEYEXCHAR command. 
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Specifying a Key or Integer 


Indicate an alphanumeric key you want to associate 
with a macro by pressing the key or by entering its ADE 
value. 


For example, the following commands both assign a 
macro to the upper case A character. After this 
command, whenever you press the upper case A 
character “a macro or string” would be transmitted. 


DEFINE A /amacroorstring/ Sr 
DEFINE 65 /amacroorstring/ r 


Each function key can be identified by a mnemonic 
abbreviation or by an integer as in Table 6-2. 


Table 6-2 
FUNCTION KEY IDENTIFIERS 


er ap ALES 


Mnemonic 


Fl function key 1 
F2 function key 2 
F3 function key 3 
Fa function key 4 
F5 function key 5 
F6 function key 6 
F7 function key 7 
F8 function key 9 
$1 shifted function key 1 
$2 shifted function key 2 
$3 shifted function key 3 
$4 shifted function key 4 
$5 shifted function key 5 
sé shifted function key 6 


shifted function key 7 
shifted function key 8 


The following commands show the two ways to assign 
“a macro or string” to function key 1. 


DEFINE F1 /amacroorstring/ Cr 
DEFINE 128 /amacroorstring/ Sr 


Associating a Macro with an Integer 


You can assign an integer value for the “key” to cause 
the macro to be associated with the specified integer. 
The valid range of integers is 144 to 34767. A macro 
associated with an integer can only be executed by a 
command from the host (or by using a special form of 
commands called ‘escape sequences”). 


The following command shows how to associate ‘a 
macro or string’ with the integer 1000. An actual macro 
would be accessed by the host issuing a command to 
the terminal: 


DEFINE 1000 /amacroor string/ Cr 
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Carriage Return and Edit Characters 


Since the carrige return control character is executed 
in Setup mode when you press the RETURN key, it 
must be treated specially to be part of a macro. The 
same is true for the keys reserved as edit characters 
(see EDITCHARS). 


The third character defined by EDITCHARS is the 
“literal” character. To include a carriage return or edit 
character in a macro, precede it with the literal 
character. 


The factory default literal character is the tilda (~). In 
the following example, the tilda key is pressed before 
the RETURN key, causing the ©r to be displayed as a 
snoopy character (instead of being executed) anda 
carriage return becomes part of the macro. (The tilda is 
shown above the r because the character entered 
after the literal character replaces it.) 


If you enter a return before the literal character, the 
carriage return is processed and an error message is 
displayed because you impropery terminated the DE- 
FINE command. If you press the ‘character delete” 
before the tilda, the terminal backspaces and deletes 
the last character entered. If you press the line edit key 
before you press the literal key, the current line is 
deleted. 


Using the Key Execute Delimiter 


When a macro is expanded by pressing the key, every 
time the terminal encounters the key execute delimiter 
it reverses the direction of the macro expansion. (When 
a macro is expanded by the “expand” command from 
the host or from the terminal in the escape sequence 
format, the key execute delimiter character is ignored.) 


In the following example, the macro starts by being 
expanded to the host. When it encounters the key 
execute toggle delimiter, it changes direction and is 
expanded to the terminal. The second key execute 
delimiter directs the flow back to the host again. 


DEFINE 128 /FORT GRAF CR Ke EcSO1 
Ke EX GRAF Cr/ Cr 


The initial direction of a macro depends on how it was 
set in the last macro that was expanded. In the 
previous example, the second key execute toggle 
character returns the flow toward the host. if it had not 
been included, the next macro would have been 
expanded by the terminal until another key execute 
toggle character was entered. 
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DELETE 


Deletes the specified file. 


(Option 42) 


DELETE filename} 


filename is an un-delimited character string 
identifying the name of the file to be deleted. 


An error resuits if the disk is write protected (by the 
WRITE PROTECT switch or the write protect notch in 
the disk) or if the file you try to delete is write protected 
by the PROTECT setup command. 


The following command would delete the file named 
“info” from the disk: 


DELETE 1 info 
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Figure 6-4. The Directory of a File. 
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DIRECTORY (Option 42) 


Displays or copies the file directory of the specified 
disk. 


DIRECTORY [filename] to [filename] 
[destination] 
[desintation- 
filename] 


if no parameter is specified, the directory of the 
disk is displayed on the screen. 


filename identifies the specific file on the disk for 
which a directory is to be displayed. 


to helps identify the direction if the directory is 
being copied. 


destination indicates the location to which a 
directory is to be copied. The “source” and 
“destination” can be the disk. If no device name 
is specified, the terminal defaults to the screen. 
Valid device names are: 


none the screen 

HO: the host port 

PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 
Filename: file on the disk 


destination-filename indicates the specific file 
to which a directory is to be copied. 


The following command causes the directory of a file 
named ‘stuff’ to be displayed on the screen 
(Figure 6-4). 


DIRECTORY 0 stuff Cr 
The directory entry for each file includes the file's 


name, size in blocks, the number of bytes in its last 
block, and whether or not it is write protected. 


The following command displays the directory for the 
entire disk in drive O (Figure 6-5). 


DIRECTORY Cr 


if you specify the host as destination for the directory, 


then be sure that the host is ready to accept data. lf 
you do not, you may lose your data stream causing 
communications problems with the host. 


DUPLEX (Option 01) 


Specifies what kind of duplex mode the terminal is in. 
(Memory) 


DUPLEX [full] 
normal} 
{auto} 
{super} 


full specifies that the terminal is in full duplex. 
This is the factory default communications mode 
for a terminal with Option 01 installed. If you 
enter the command word and no parameters, the 
terminal defaults to “full.” 


normal specifies that the terminal is to be in “Half 
Duplex Normal” mode. 


auto puts the terminal into “Half Duplex with 
Automatic Request to Send” mode. 


super puts the terminal into “Half Duplex with 
Supervisor” mode. 


eee ere | 
Section 5 in this manual provides a very brief overview 

of the terminal’s communications modes. See the 4112 

Host Programmer's Manual for information. 
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Figure 6-5. Directory for a Disk. 
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ECHO 


Specifies whether or not the terminal provides an 
“echo” of characters typed on the keyboard and sent 
to the host computer. 


ECHO yes} 
{no} 


yes is a keyword meaning that the terminal will 
provide the echo. If you enter the command word 
but do not specify “yes” or ‘‘no,” the terminal 
defaults to “yes.” 


no is a keyword meaning that the terminal will not 
provide the echo. This is the factory default. 


The “echo” is the display of characters on the terminal 
screen as they are typed at the keyboard. 


When the terminal is in Setup or Local modes, the echo 
is provided by the terminal regardless of the status of 
ECHO. 


If the computer you log onto is a remote-echo host, it 
provides the echo for you automatically. If you set the 
terminal to provide the echo, too, each character is 
echoed twice when you are in communications with the 
host — once by the terminal and once by the host. 


If the computer you log onto is not a remote-echo host, 
enter the following command so the terminal will 
provide the echo when you are communicating with the 
host: 


ECHO yes Cr 
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EDITCHARS 


Specifies “delete” characters for Setup mode anda 
“literal” character to precede control characters in 
macros. 


EDITCHARS chardel, linedel, literal 


chardel can be any ASCII character except the 
“linedel” or “literal” characters. Specify a 
character by pressing the appropriate key or 
entering its ADE (ASCII Decimal Equivalent) val- 
ue. The ‘chardel” character is used in Setup 
mode to backspace along a line to correct a 
typing error. The factory default is RUB OUT (ADE 
127). 


linedel can be any ASCII character except the 
“chardel” or “literal” characters. Specify a char- 
acter by pressing the approriate key or entering 
its ADE value. The “‘linedel’’ character is used in 
Setup mode to abort a line without executing it, 
and Start a new line. The factory default is 
“cancel” (ADE 24). Type the cancel character 
from the keyboard by pressing the CTRL and X 
keys at the same time. 


literal can be any ASCII character except the 
“chardel” or “linedel” characters. Specify a char- 
acter by pressing the appropriate key or entering 
its ADE value. The factory default literal character 
is the “tilda” (~) (ADE 126). The “litera!” must 
precede the following characters if they are 
included in a macro: 


a carriage return 
the character delete 
the line delete 

the literal character 
The following command specifies the “chardel,” 
‘Iinedel,” and “literal” characters as the percent sign 
(%), pound sign (#), and dollar sign ($), respectively. 


EDITCHARS % # $ Cr 
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If you are in Setup mode and you need to delete one or 
more characters, press the ‘‘%'’ key to back up along 
that line to correct or change it. Press the “#" key to 
back up to the beginning of the line. 


If the dialog area is not used, the terminal will always 
overwrite characters when you use the “chardel” key 
— it will not replace the characters. If the dialog area is 
not used, the “‘linedel’” key moves down to the next line 
instead of to the beginning of the current line. 


Use of the literal character ($ in this example) is 
illustrated with the DEFINE command. 


You don't have to enter all three parameters if you only 
want to change the first or second edit characters. For 
example, if you only want to change the ‘character 
delete” character, you could enter the following com- 
mand: 


EDITCHARS & Sr 
That command changes the character delete character 


to & and jeaves the line delete and literal characters at 
their current specifications. 


if you specify the same character for all three parame- 
ters, it will be used as the character delete character. 
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EOFSTRING 


Specifies the string which is automatically sent to the 
host by the terminal when it detects an end of file and 
which the terminal uses to end a file being sent to it 
during a SPOOL, COPY, or PCOPY. 

(Memory) 


EOFSTRING “istring®L 


D. is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, or edit character (see EDITCHARS) is the 
delimiter character for this command. 


string is a delimited combination of up to ten 
ASCII characters. The first character cannot be 
repeated elsewhere in the string. The default is 
the null string. If you enter just the command 
word and no string, the terminal defaults to the 
null string. 


When the terminal is copying a file from the host, it 
terminates the copy when it encounters the end of file 
string. 


The end of file string should be set to whatever the host 
computer actually sends at the end of a file. If you do 
not, you will have to press the CANCEL key to close 
disk files. 


In the following command, the slash (/) is the delimiter 
and the end of file string is set to an ampersand (&). 


EOFSTRING /&/ Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk (see Section 3). If it is not, you may need 
to consult with a system programmer for your host 
computer before using this command. 
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EOLSTRING 


Assigns the end of line string used by the terminal. 
(Memory) 


EOLSTRING °% string % 


DL is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, character (see EDITCHARS) is the delimi- 
ter character for this command. 


string is the character string the terminal uses to 
signal the end of the transmission of a line of 
data. The factory default is the Carriage return. 


The “end of line string” is sent by the terminal at the 
end of (or during) transmissions generated by the 
terminal. 


When a host program requests information from the 
terminal, it may be sent automatically, not requiring 
operator interaction. For example, the program may 
request a report of error messages or some graphics 
input data. In such cases, the terminal sends an end of 
line character to the host to indicate the end of a 
transmission. 


The following command changes the end of line string 
to the ‘& (line feed): 


EOLSTRING ‘r’ Cp 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 


4112 OPERATOR'S 


SETUP COMMANDS 


EOMCHARS 


Specifies the end-of-message (turnaround) characters. 
(Memory) 


EOMCHARS [char1] 
[char1, char2] 


chart and char2 are un-delimited ASCII charac- 
ters. If you specify just one character, the second 
character is set to null. If you do not specify 
either character, both are set to null and no end of 
message checking is done at all. The default end 
of message characters are ©r (carriage return) 
and “i (null). 


If the terminal is in Prompt mode, Block mode or Halt 
Duplex mode, it stops transmitting when it encounters 
either ‘‘end of message” character. (See the PROMPT- 
MODE, BLOCKMODE, and DUPLEX commands). 


In Prompt mode, for example, when an end-of-message 
character is transmitted the terminal terminates 
transmission until it receives a prompt. 


The following command would set the end of message 
Characters to ‘+ (line feed) and &c (escape). 


EOMCHARS '‘r fc Cpr 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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ERRORLEVEL 


Specifies how severe an error must be before it is 
displayed by the terminal. 


ERRORLEVEL (0) 
1) 
12} 
3} 
(4) 


O specifies that all messages, warnings, errors, 


and terminal failure messages should be dis- 
played. If you enter just the command word and 
no parameter, the error level is set to 0. 


1 specifies that warnings, errors and terminal 
failure messages should be displayed. 


2 specifies that errors and terminal failure mes- 
sages should be displayed. This is the default. 


3 specifies that only terminal failure messages 
should be displayed. 


4 suppresses all messages, warnings, errors, and 
terminal! failure messages. 
see ne a ne ae AR Rte | 
The ERRORLEVEL command does not affect error 
messages that are generated by host resident software 
programs or the host computer. 


The terminal's error messages are stored in an error 
queue whether or not they are displayed. The applica- 
tion program can examine that queue for an error 
report. 


The following command would set the terminal so that 
only terminal failure messages are displayed: 


ERRORLEVEL 3 ‘Cn 


Appendix A lists the terminal's warnings, error 
messages and terminal failure messages. 
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FIXUP 


Specifies when and how thoroughly a viewport is 
updated when a change is made that affects it. 
(Memory) 


FIXUP level 


level is an integer parameter with a value of 0, 2, 
4 or 6. Each value specifies when changes are 
made in a viewport due to changes made that 
affect it: 


O the screen is updated when you press the 
PAGE key. 


2 the actions for fixup level O are taken and 
the display is also updated as changes are 


made to the current view. 


4 the actions for levels 0 and 2 are taken and 
the current viewport is updated when a seg~ 
ment is moved. 


6 the actions for levels 0, 2 and 4 are taken 
and segments are immediately erased from the 
viewport if they are deleted or made invisible. 
This is the factory default. 


The higher the value of the “level” parameter, the more 
the current view is updated as it is changed. 


If you enter just the command word with no parameter, 
the level is set to 0. 


Regardless of the fixup level, the current view is always 
completely updated when you press the PAGE key; the 
specified view is updated whenever you issue the 
RENEW setup command. 
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FLAGGING 


Specifies whether or not the terminal is to use flagging, 
and if so, what kind of flagging. 


(Memory) 

FLAGGING ([none} 
{input} 
{output} 
{inout} 
{dtr} 


none is a keyword indicating that flagging is not 
to be done. This is the factory default. 


input is a keyword indicating that when the 
terminal’s input buffer is full, it sends a DC3 
character character to stop the host; the terminal! 
sends a DC1 character when it is ready to receive 
data again 


output is a keyword indicating that the DC1 and 
DC3 characters are used for flagging. 


inout is a keyword indicating that the terminal 
and host both use the DC1 and DC3 characters to 
flag each other as to when to start and halt 
communications. 


dtr is a keyword indicating that when the termi- 
nal’s input queue is nearly full it lowers the DTR 
(DATA TERMINAL READY) line on the RS-232 
connector; when the terminal's input queue is 
ready for more data, the terminal raises the line. 


For output, when the host lowers the CTS (CLEAR 


TO SEND) line, the terminal stops sending data; 
the terminal resumes transmission when CTS 
goes high again. 


Flagging allows the terminal and host computer to 
indicate to each other when they are ready to send or 
receive data. This prevents their input buffers from 
overflowing, which would cause data to be lost. 


The following command would cause the terminal to 
use input flagging: 


FLAGGING input Cr 

Whether or not the terminal should use flagging, and 
what kind of flagging mechanism it does use depends 
on your host computer. 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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FORMAT 


Formats a flexible disk so it can be used to store data. 


(Option 42) 


FORMAT diskname [files] 

diskname is an un-delimited string of up to nine 
alphanumeric characters identifying the disk; a 
space cannot be included in the ‘‘diskname.” If no 
“diskname” is given but a device is specified, no 
“diskname” is assigned. 


files is an integer specifying the maximum num- 
ber of files that can be created on the disk. The 
default is 368; the valid range is 368 to 1872. 


A disk must be formatted before it can be used. If you 
format a disk which already has files on it, the files are 
inaccessible. 


If you specify a number less than 368, the disk is 
formatted for 368 directory entries. If you specify a 
number greater than 1872 the disk is formatted for 
1872. If the number you specify is not divisible by 16, it 
is rounded up to the nearest multiple of 16. 


A disk cannot be formatted if it is write protected by the 
WRITE PROTECT switch (see Section 2) or when the 
write protect notch in the disk is not covered (see 
Section 3). 


The following command formats the disk for 384 files 
and names the disk SALESDATA. 


FORMAT SALESDATA 384 Cr 


seer vrr es + 


» 4 

: CAUTION « 
FO SEO ge BS 

Do not open the door to the disk drive while the 

disk is being formatted. If you do, you must close 

the door, press the RESET button to reset the 


terminal, and then reformat the disk. 
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GAMODE 


Specifies background for alpha text in the graphics 
area. 
(Memory) 


GAMODE replace} 
foverstrike} 


replace specifies that only the character itself is 
displayed; the rest of the character cell is not 
displayed. This is the factory default. 


overstrike specifies that the character cell not 
used by the character is displayed in the same 
gray level of the current background gray-level 
(see DAINDEX). 


This command is similar to DAMODE except that it 
affects the display of alpha text in the graphics area 
instead of in the dialog area. 


If you enter just the command word and no parameter, 
the parameter is set to overstrike. 
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GRIDDING 


Establishes a grid on the terminal's screen for use in 
graphics input (GIN) mode. 


GRIDDING device-function. [xarid, yarid] 


device-function indicates the graphics input 
device used and what function is being performed 
by the input device. Valid specifications are: 


O thumbwheels for locator function 
1 thumbwheels for pick function 
8 tablet for locator function 
9 tablet for pick function 
24 port O for locator function 
25 port 0 for pick function 
32. port 1 for locator function 
33 port 1 for pick function 
40 port 2 for locator function 
41 port 2 for pick function 


xgrid specifies the distance between the grid 
lines parallel to the x-axis. The default when the 
terminal is turned on is zero; if you do not enter a 
value for ‘‘xgrid” it is set to zero. The valid range 
is from O to 4095. 


ygrid specifies the distance between the grid 
lines parallel to the y-axis. The default when the 
terminal is turned on is zero; if you do not enter a 
value for “ygrid” it is set to zero. The valid range 
is from 0 to 4095. 


Gridding is usually set by a host program when it puts 
the terminal into graphics input (GIN) mode. It can help 
you draw lines or locate a point more precisely. 


The following command sets up a 100 x 100 grid for 
the terminal’s thumbwheels for the locator function: 


GRIDDING 0 100 100 Cr 
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IGNOREDEL 


Specifies whether or not the terminal ignores the delete 
(RUBOUT) character. 
(Memory) 


IGNOREDEL yes! 
ino} 


yes is a keyword indicating that the delete 
character should be ignored. 


no is a keyword indicating that the delete charac- 
ter should not be ignored; this is the factory 
default. 


You should only set this parameter to “yes” if your 
program uses §c <?> asa substitute for the ° in 
graphics. 


The following command changes the setting of 
IGNOREDEL to “yes”: 


IGNOREDEL Cr 
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KEYEXCHAR 


Specifies the “key execute delimiter’ character, 
(Memory) 


KEYEXCHAR char 


char specifies the “key execute delimiter.” Any 
ASCII character can be used, but it is best to 
choose one that is not used in a typical text 
string. The factory default is °c (CTRL-P). 


The ‘key execute delimiter’ determines whether a 
macro is expanded by the terminal or the host. When a 
macro is being expanded by the host and the termina! 
encounters the key execute delimiter, the direction is 
reversed so the terminal is executing the macro. When 
it encounters another key execute delimiter, it causes 
the host to begin to expand the macro again. 


if the terminal is in Local or Setup mode, all macros are 
expanded locally and the key execute delimiter is 
ignored. 


The following command would define °n as the key 
execute delimiter: 
KEYEXCHAR 24 ‘Sr 


For an example of the use of the key execute delimiter, 
see the DEFINE command earlier in this section. 
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LFCR 


Specifies whether the line feed character is interpreted 
as a line feed or a line feed-carriage return. 
(Memory) 


LFCR  lyes! 
ino} 
yes is a keyword indicating that the terminal 
should attach a carriage return character to each 
Le (line feed). 


no is a keyword indicating that the terminal 
should not attach a carriage return character to 
each ‘ (line feed). 


A carriage return causes the Cursor lo move to Ine lert 
margin of the current line; a line feed moves the cursor 
down one line from its current position. A carriage 
return-line feed combination moves the cursor to the 
left margin of the next line. 


The following command would cause the terminal to 
attach the carriage return character to the line feed: 


LFCR Cr 


When the terminal is in Local mode, it is necessary to 
change the parameter to “yes” if you want to get the 
carriage return-line feed combination by pressing just 
the LINE FEED key. 
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LOAD 


Reads a file and executes it as a command file. 
(Option 42) 


LOAD [filename] 
[source-filename] 


filename specifies the name of the file to be read. 
If no source is specified, the terminal defaults to 
the disk drive. 


source-filename specifies the source of the file 
and the name of the specific file to be read. Valid 
sources are: 


HO: host computer port 
PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


Pressing the CANCEL key aborts the loading of a file. 
All other input to the terminal is queued until the file is 
loaded or aborted. 


Nesting of LOAD commands is allowed. That is, a file 
being loaded can in turn contain a LOAD command. 
That file can also contain a LOAD command, and so on. 
The limitation of nesting varies, depending on how busy 
the terminal is with other tasks. 


This command loads the file named INITIALIZ from the 
disk: 


LOAD INITIALIZ Cn 
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LOCKKEYBOARD 
Locks the terminal’s keyboard. 
LOCKKEYBOARD 


No parameters need to be entered. As soon as you 
enter the carriage return, the keyboard is locked. 


When the keyboard is locked you can still press the 
keys, but the characters are not echoed on the screen. 
The terminal's bell rings when you press any key 
except the BREAK or CANCEL. 


The keyboard should usually be locked and unlocked 
by the application program. 
OT i 
: CAUTION , 
Rip in Rie paps 
Pressing the CANCEL key, or the RESET button 
may cause you to lose information on the screen 
or halt other terminal operations in process. Do 
not do so unless you are sure you will not lose 
important data. 


You can unlock the keyboard by pressing the CANCEL 
key, the BREAK key, or the RESET button. 
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PAGEFULL 


Specifies action to be taken when the “page full” 
condition occurs. 


(Memory) 

PAGEFULL {none} 
{stop} 
{autocopy} 
ibreak} 


none is a keyword meaning that no action is 
taken; when the cursor reaches the last line of 
the display, it returns to the upper left corner and 
continues, writing over any text already there. 
This is the factory default. If you enter the 
command word with no parameter, it is set to 
“none.” 


stop is a keyword meaning that when a page full 
condition occurs, the terminal stops displaying 
text. Incoming text is stored in the input queue 
and displayed when the page full condition is 
cleared. 


autocopy is a keyword meaning that when a page 
full condition occurs, the terminal makes a hard 
copy of the screen, erases the screen, and 
continues. While the hard copy is being made, 
incoming text is stored in the terminal’s input 
queue. 


break is a keyword meaning that when a page full 
condition occurs, the terminal sends an interrupt 
to the host to discontinue the sending of informa- 
tion (the equivalent to pressing the BREAK key). 


If flagging is not being used (see the FLAGGING 
command in this section, the communications overview 
in Section 5, and the 4112 Host Programmer's Manual) 
the input queue may be overrun when you use 
“autocopy” due to the time it takes to make the hard 
copy. If this is the case, you may want to use a flagging 
mechanism or the QUEUESIZE command to be sure 
that the input queue is large enough so that it is not 
overrun. 


The following command sets the terminal so that when 
a page full condition occurs, it makes a hard copy, 
erases the screen, and then continues. 


PAGEFULL autocopy Cr 
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PARITY Parity is a means for verifying the accuracy of com- 
munication between the terminal and a host computer. 
Specifies the kind of parity used by the terminal for The terminal does not check parity on input, but it can 
checking input and when transmitting to a host. be set to transmit data according to the host compu- 
(Memory} ter's parity convention. 
PARITY jnone; The following command sets the terminal to transmit 
thigh} odd parity: 
4 
even} c 
odd PARITY odd Cnr 
idatal This parameter may be set by an applications program 
==, on the host computer or by an initialization file ona 
none means that the parity bit is set to O for flexible disk. If it is not, you may need to consult with a 
transmission of data. system programmer for your host computer before 


; es. using this command. 
high means that the parity bit is set to 1 for 


transmission of data. 


even means that the sum of the bits in the byte 
must be even for output. 


odd means that the sum of the bits in the byte 
must be odd for output. 


data means that ail eight bits are used to send 
data for output. 


— 
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PASSIGN (Option 10) 


Assigns a device driver and/or an identification code to 
the specified port. : 
(Memory) 


PASSIGN port, device 


port identifies the port to which a device driver 
and/or an identification code is assigned. Valid 
port specifications are: 


PO: peripheral port 0 
Pi: peripheral port 1 
P2: peripheral port 2 


device is an integer that identifies the device 
driver is assigned to the specified port. Valid 
device drivers are: 


Device Meaning 


4643 Tektronix 4643 line printer. 


4662 Translates terminal commands into 
4662 commands and 4662 
commands into terminal com- 
mands; the plotter must be used in 
Block mode. 


4662/NT Does not translate commands be- 


tween the terminal and 4662. 


Same as “4662” driver, but 
includes pen changing support 
added by the plotter’s multiple-pen 
option. 


4662/MP 


4663 Translates terminal commands into 
4663 commands and 4663 com- 
mands into terminal commands; the 
plotter must be used in Block mode. 


Translates terminal commands into 
4663 commands and 4663 com- 
mands into terminal commands: the 
plotter must be used on Continuous 
Communications mode (use 
DC1/DC3 or CTS/DTR flagging). 


Does not translate commands be- 
tween the terminal and the 4663; 
plotter must be used on Continuous 
Communications mode. 


4663/NB 


4663/NT 


PPORT General purpose; supports any 
Tektronix device with an RS-232 


connector. 
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If you attach a device to a port, the device must be 
compatible with the assigned driver. 


The following command assigns the 4663 device driver 
to peripheral port 0: 

PASSIGN PO: 4663 Cr 

This command assigns the general purpose device 
driver to peripheral port 2: 

PASSIGN P2: PPORT ‘R 
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PBAUD 


Assigns a rate for transmitting and receiving data for 
the specified port. 
(Memory) 


(Option 10) 


PBAUD port, baudrate 


port indicates which port is receiving a baud rate 
assignment; valid port assignments are: 


PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


baudrate is an integer which specifies the rate at 
which data will pass through the assigned port. 
The factory default is 2400. 


The baud rate that you assign to each port must be 
compatible with the baud rate of the device you attach 
to the port. If it is not, there will be communications 
problems. 


Valid baud rates are: 


50 
75 
110 
134(sets baud rate to 134.5) 
150 
300 
600 
1200 
1800 
2000 
2400 
3600 
4800 
7200 
9600 


The following command sets the baud rate at 1200 for 
oeripheral port 2: 


PBAUD P2: 1200 Cr 
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PBITS (Option 10) 


Specifies the stop bit and data bit convention for the 
indicated peripheral port. 
(Memory) 


PBITS port, stopbits, databits 


port indicates the port for which the stop-bits and 
data bits conventions are specified. Valid ports 
are: 


PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


stopbits is an integer specifying the minimum 
number of bits following the data bytes in the 
communications with the device attached to the 
port. The integers 1 and 2 are valid; the factory 
default is 2. 


databits indicates the length in bits of the data 
bytes used to communicate with the device 
attached to the port. The integers 5,6, 7, and 8 
(representing 5-bit, 6-bit, 7-bit, and 8-bit bytes) 
are valid. The factory default is 8. 


The standard ASCII character has 7 data bits and one 
parity bit (see PPARITY later in this section.) 


Both ‘“stopbits” and ‘‘databits” for a port must be 
compatible with the device that is attached to that port. 
if they are not, there will be communications problems. 


The following command sets the data bit size to 7 and 
stop bits to 1 for peripheral port O: 


PBITS PO: 1 7 Cr 
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PCOPY 


Two 
1. 


(Option 10) 
Establishes a two-way data path between two devices. 


PCOPY source to destination 


source indicates the device which initiates and 

terminates the communication. Valid devices are: 
HO: 
PO: 
P1: 
P2: 


the host port 

peripheral port 0 
peripheral port 1 
peripheral port 2 


to is a keyword that helps you remember the flow 


of the copy — from the source to the destination. 


destination specifies the device which is origin- 
ally on receiving end of the communication path. 
Vatid devices are: 
HO: 
PO: 
P1: 
P2: 


the host port 

peripheral port O 
peripheral port 1 
peripheral port 2 


Since the data path is two-way, the two devices can 
carry on communication without involving the terminal. 
It is as if the terminal were not present and the two 
devices were connected directly to each other. 


The connection between the devices is established by 
the PCOPY command. Communications must be start- 
ed by the “source” device. The connection is broken 
when the terminal detects an end-of-file string (see 
PEOF) from the source device, when you press the 
CANCEL key, or if there is an error. 


The Setup mode prompt reappears on the screen when 
the PCOPY is finished. The first 130 characters you 
type during a PCOPY are stored in a queue. They are 
echoed and executed when the PCOPY is finished. 


The following command allows the host and the device 
attached to peripheral port 2 to transfer data without 
involving the terminal: 


PCOPY HO: to P2: Sr 

If the source device is the host (HO:), then you must 
arrange to begin the data stream before you enter the 
command in Setup mode, because once the command 
is entered the terminal will wait for a data stream from 
the host until an end-of-file comes from the host or the 
CANCEL key is pressed. 
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ways to start the data stream appropriately are: 


Type the command to the host to start the data 
stream without the end-of-command character 
from outside of Setup mode, enter Setup mode, 
type in the PCOPY command with the desired 
destination, exit Setup mode, and type the end-of- 
command character. This should start the data 
stream from the host. If your host echos the 
characters typed on the terminal this method 
results in the end-of-command character being the 
first character in the data stream. 


Program the host so that there is a delay between 
the time you enter the end-of-command character 
for the host-data-send command and the time the 
data stream begins to flow. If you use this method 
you should give yourself enough time to enter 
Setup mode and type the PCOPY command with 
the desired destination. 
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PEOF (Option 10) 


Specifies the string to be sent to the peripheral port 
when an end-of-file is detected by the terminal. 
(Memory) }) 


PEOF port, “:string®t 


port indicates the port for which the specified 
string denotes end-of-file. Valid ports are: 


PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


D_ is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, or edit character (see EDITGHARS) is the 
delimiter character for this command. 


string is a delimited string of up to ten ASCII 
characters. The factory defauit is the null string. 


The port-EOF string that you assign to a port should be 
the same as the end of file string for the device 
attached to that port. 


In the following command the slash (/) is used as the 
delimiter and the “peripheral end of file” string is 
changed to “??27?." 


PEOF P1: /27?7?/ Cr 
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PEOL (Option 10) 


Assigns the end-of-line string to be used by the 
specified port. 
(Memory) 


PEOL port, °string®L 


port indicates the port for which the specified 


string denotes end-of-line. Valid ports are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


D. is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, or edit character (see EDITCHARS) is the 
delimiter character for this command. 


string is a delimited string of one or two ASCII 
characters. The factory default is a carriage 


return. 
a a ve ne Oe EE 


The port-EOL string that you assign to a port should be 
the same as the end of file string for the device 
attached to that port. 


In the following command, the end of line string is set 
to be a ‘r (line feed) for peripheral port 0. 


PEOL PO: ‘tr’ Cr 
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PFLAG 


(Option 10) 
Sets the Flagging mode for the specified peripheral 
port. 
(Memory) 


PFLAG port, flag, [go], [stop] 


port indicates the port for which Flagging mode is 
being defined. Valid ports are: 


PO: peripheral port 0 
Pt: peripheral port 1 
P2: peripheral port 2 


flag indicates which of the three types of flagging 
is to'be assigned. 


NONE = no flagging 
CHAR = character flagging (factory default) 
DTR. = DTR/CTS (hardware) flagging 


go is a single character parameter which can be 
specified when “character flagging” is used. The 
terminal uses the “go” character to indicate that 
data transmission can proceed. Any ASCII char- 
acter is valid; DC1 (ADE 17) is the factory default. 
If no character is specified, go” defaults to DC1. 


stop is a character parameter which can be 
specified when “character flagging” is used. The 
terminal uses the “stop” character to indicate 
that data transmission should stop. Any ASCII 
character is valid; DC3 (ADE 19) is the factory 
default. If no character is specified, “stop” 
defaults to DC3. 


The following example specifies that flagging is not 
used at peripheral port 0: 


PFLAG PO: NONE CR 


This cornmand causes peripheral port 1 to use charac- 
ter flagging with “?" as the go” character and the 
default DC3 as the stop” character: 


PFLAG P1: CHAR ? CR 
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PICKAPERTURE 


Specifies the a" square within which the graphics 
input device can “pick” an object. 
(Memory) 


PICKAPERTURE [size] 


size specifies the side of the square within which 
the graphics input device is centered. The default 


when the terminal is turned on or reset is 8. If you 
do not specify a size, the terminal defaults to O. 


The following command specifies a pick aperture of 4. 
This creates a 4 x 4 square with the graphics input 
locator centered in the square. If you attempt to “pick” 
an object, it must have its X and Y coordinates within 
two units (plus or minus) of the tocator device in order 
to be detected. 


PICKAPERTURE 4 Cp 
See the 4112 Host Programmer's Manual and the 4110 


Series Command Reference for details on “picking” 
objects on the screen. 
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PLOT (Option 10) 


Copies all currently visible segments to the specified 
output device. 


PLOT to [destination] 
[destination-filename] 
to is a keyword to help you remember the flow of 
the PLOT 


destination indicates the device to which the 
segments will be copied and the specific file to be 
copied. If no destination is specified, the terminal 
defaults the disk drive. Valid ports are: 


HO: the host port 

PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


destination-filename specifies the destination of 
the plot and the specific file to which the plot is to 
be sent. 


if the “destination” parameter is a port that has been 
assigned a 4662 or 4663 driver (see the PASSIGN 
command), terminal commands are converted into 
plotter commands. Otherwise, plots are sent as to the 
specified device as terminal commands. 


\f you specify the host as destination, then be sure that 
the host is ready to accept the data, Otherwise you may 
lose your data or cause problems with the host. 


The following command copies the currently visible 
segments to the file named “picture1" on the disk: 
PLOT to picture1 Cr 

This command copies the segments to the device on 
peripheral port 2: 

PLOT to P2: Cr 
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PMAP (Option 10) 


Assigns one or more gray indices to a plotter pen 
number. 


PMAP port, index, pen 


port indicates the port for which the index-to-pen 
assignment is valid. 


index specifies the gray index assigned to a pen. 
A pen can have more than one index assigned to 
it. Valid index numbers are integers from —2 
through 255. 


—2 means to “unmap” (disassociate) all in- 
dices. : 


—1 means to map all gray indices to the given 
pen. 


O—255 means to map the given gray index to 
the given pen. 


pen specifies the pen to which a gray index is 
mapped. Valid pen numbers are integers from —1 
to the number of pens on the plotter: 


—1 means that ail plotter pens are to be 
“unmapped” (disassociated) from all gray in- 
dices: this can only be used if “index” is set to 
—2. 


O “unmap” the pen. 


1—N specifies the pen number. 
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Each time the terminal is turned on, all gray-scale 
indices are initialized to pen O. 


When data is drawn on the plotter, all lines with a 


mapped gray index are drawn by the specified pen. Any 


index without a pen assignment is not be drawn by the 
plotter. 


Mapping a gray-scale index to one pen automatically 
“unmaps’” that index from any other pen. This means 
that while one pen can have several indices assigned 
to it, an index can be assigned to only one pen ata 
time. 


The following command maps gray index 6 to plotter 
pen 1, attached at peripheral port 2: 

PMAP P2: 6 1 Sr 

This command “unmaps” all indices previously 
assigned to pen 1: 

PMAP P1: —2 1 rR 


4112 OPERATOR'S 


SETUP COMMANDS 


PPARITY 


Assigns a Parity mode to the specified port. 
(Memory) 


(Option 10) 


PPARITY port, {low} 
todd} 
{even} 
thigh} 
{none} 


port indicates the port for which parity is being 
assigned. Valid ports are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


low is a keyword indicating that the parity bit is 
given a value of 0. 


odd is a keyword indicating that the value of the 
parity bit is assigned such that the sum of all bits 
in the byte is odd. 


even is a keyword indicating that the value of the 
parity bit is assigned such that the sum of all bits 
in the byte is even. 


high is a keyword indicating that the parity bit is 
given a value of 1. 


none is a keyword indicating that there is no 
parity check. 


A standard ASCII character with parity would have 
seven data bits (see PBITS) and one parity bit. 


The following command sets the terminal for even 
parity checking on peripheral port 2: 


PPARITY P2:even Cr 
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PROMPTMODE 


Specifies whether or not the terminal is in Prompt 
mode. 
(Memory) 


PROMPTMODE yes} 
{no} 


yes is a keyword which causes the terminal to 
enter Prompt mode. 


no is a keyword which causes the terminal to exit 
Prompt mode. This is the factory default. 


When the terminal is in Prompt mode, data from the 
terminal is stored in a queue and transmitted to the 
host when it is prompted to do so. If you press the 
CANCEL key, the terminal flushes the queue. If you 
turn Prompt mode off, all the characters in the queue 
are sent to the host. 


The characters used to prompt the terminal are defined 
by the PROMPTSTRING command. After the terminal 
enters Prompt mode, the first prompt string is dis- 
played. Subsequent prompt strings are executed, but 
not displayed. If you press the CANCEL key, Prompt 
mode starts over — that is, the first prompt after 
pressing CANCEL is displayed and subsequent 
prompts are executed. 


The following command would cause the terminal to 
enter Prompt mode: 


PROMPTMODE yes ‘na 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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PROMPTSTRING 


Specifies the prompt sequence. 
(Memory) 


PROMPTSTRING “:string® 


D. is the delimiter character, which must precede 
and follow each parameter. The first character 
after the command word that is not a comma, 
space, or edit character (see EDITCHARS) is the 
delimiter character for this command. 


string is a delimited string of up to ten ASCII 
characters. The factory default is the null string. 


The prompt string you specify must conform to the 
prompt string actually sent by your host computer. 


The following command is an example of defining a 
prompt string: 


PROMPTSTRING /+&%/ Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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PROTECT 


Specifies the write protect status for a disk or file. 


(Option 42) 


PROTECT [devicel 
[device-filename] [yes] 
[filename] [no] 


device indicates the disk drive containing the 
disk that is to be protected or unprotected. The 
valud device name for the disk drive is: 


FO: 


filename specifies the individual file that is to be 
protected or unprotected. Valid filenames are 
alphanumeric strings of up to nine characters. If 
no device is specified, the terminal defaults to the 
disk drive. 


yes is a keyword meaning that the file or disk 
should be protected. “Yes” is the default: if you 
do not specify “no” then the file or disk is 
protected. 


no is a keyword meaning that the file or disk 
should be unprotected. 


A protected file must be unprotected before it can be 
deleted or overwritten. A protected disk cannot be 
copied, however it can be reformatted. You cannot use 
the PROTECT command if the disk is already protected 
by the disk drive’s WRITE PROTECT switch, 

The following command protects the disk in drive 0: 
PROTECT FO: Cr 

This command protects the file named “important” on 
disk drive 1: 

PROTECT FO:important Cr 
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QUEUESIZE 


Specifies the size of the terminal's input queue. 
(Memory) 


QUEUESIZE bytes 


bytes is an integer, specifying the size of the 


input queue. The factory default is 300. 


When the terminal receives data from the host faster 
than it can be processed, it stores the data in the input 
queue. 


If the input queue fills up and flagging (see FLAGGING) 
is not being used, the terminal ignores incoming data or 
text until there is more room in the queue. if a flagging 
mechanism is being used and the queue fills up, the 
terminal flags the host to stop sending data. When 
there is more room in the queue for more data, the 
terminal flags the host to resume sending data. 


The following command sets the input queue to 500 
bytes: 


QUEUESIZE 500 Cr 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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RENAME (Option 42) 
Changes the name of a file on the specified disk. 


RENAME oldname to newname 


st 
oldname is an undelimited alphanumeric string of 
up to nine characters indicating the current name 
of the file. 


to is a keyword which helps distinguish between 
current name of the file and its new name. 


newname is an undelimited alphanumeric string 
of up to nine characters indicating the new name 
of the file. 


— 


An error results if a file already exists with the newly 
specified name. An error also occurs if no file with the 
specified “oldname” exists, or if the file you are 
attempting to rename is write protected (by the WRITE 
PROTECT switch, the write protect notch in the disk, or 
by the PROTECT command). 


The following command changes the file named 
“wrong” to “right”: 


RENAME wrong to right °r 
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RENEW 


Erases the specified viewport and redraws all visible 
segments. 


RENEW view 


view is an integer parameter in the range from 


—1 to 64. A value of —1 renews ail viewports; 
1 —64 renew the specified viewport. 


When a viewport is renewed, it is completely updated 
to reflect all changes made to it since it was updated 
last. See the FIXUP command for more details. 
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REOM 


Specifies when the “end of message” string is sent in a 
series of graphics input (GIN) reports. 
(Memory) 


REOM (1} 
{0} 


1 specifies that the end of line string is sent after 
each report element and at the end of the report. 
This is the factory default. 


0 specifies that the end of line string is sent only 
at the end of the report. 


This command should be set by the applications 
program. if it has not been, you may need to see a 
system programmer for your host system for more 
information. 
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RLINELENGTH 


Specifies the maximum length of a terminal report sent 
to the host computer. 


RLINELENGTH length 


length specifies the maximum length in charac- 
ters for reports the terminal sends to the host 


computer. The factory default is 0. A specification 
of O sets the maximum length to infinity. 


See the 4110 Series Command Reference Manual for 
details. 
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SAVE 


Saves the specified item(s) to the specified file or 
device. 


SAVE ‘macro! {id} to [destination-filename] 
{segment} [filename] 
{ras} 
trun} 
inumpix]} 


macro is a keyword indicating that a macro is to 
be saved. 


segment is a keyword indicating that a segment 
is to be saved. 


ras saves pixels using “raster write’ commands. 


run saves pixels using ‘run length write” com- 
mands. 


id is an integer parameter identifying the macro 
or segment to be saved. 


Valid macro identifiers for a macro are —1 and 1 
to 32767. If you indicate “all” or —1, all currently 
defined macros are saved. The values 1 to 127 
save the macro associated with the correspond- 
ing ASCII key, 128 to 143 saves macro with the 
the corresponding function keys, and 144 to 
32767 save macros associated with integers. See 


the ASCII chart in Appendix D and the DEFINE 
command for more details. 


Valid segment identifiers are —3, —1,and 1 to 
32767. —3 saves all segments in the current 
matching class, —1 or “all” saves all existing 
segments, and 1 to 32767 save specific 
segments. See the Host Programmer’s Reference 
Manual for details. 


numpix is an integer parameter used when “ras” 
or “run” is the first parameter. It is within the 
range from —1 to 32767, specifying the number 
of pixels to be saved. —1 means to save all pixels 
in the viewport. 1—32767 means to save the 
specified number of pixels starting at the current 
beam position. 


to is a keyword which indicates the flow of the 
data: it is saved from the terminal memory (macro 
or segment) to the specified destination. 


(continued) 
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destination indicates to which device the data 
should be saved. 


HO: host port 

PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


filename is an undelimited string of up to nine 
alphanumeric characters identifying the file into 
which the macro or segment is to be saved. If the 
filename is specified and a destination is not 
specified, a file by that name is created on the 
disk. 


You can save files to and from the host without the disk 
drive and three port peripheral options. You can save 
files to the disk(s) if you have the disk option (Option 
42). You can use the peripheral ports if you have the 
three port peripheral option (Option 10). 


Graphics and macros that are saved can be put back 
into terminal memory with the LOAD command. 


If you specify the host as destination, then be sure that 
the host is ready to accept the data stream, or you may 
lose your data or cause communications problems with 
the host. 


The following command would save all current seg- 
ments to the device attached to peripheral port 2: 
SAVE segment all to P2: Cr 

This command saves macro number 579 in the file 
named “macfile”: 

SAVE mac 579 to macfile Cr 

For more detailed information on pixel saving opera- 


tions, see the 4112 Host Programmer's Manual and the 
4110 Series Command Reference Manual. 
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SNOOPY 


Specifies whether the terminal should display control 
characters instead of executing any of them. 


SNOOPY {yes} 
{no} 


yes is a keyword indicating that Snoopy mode 
should be initiated. 


no is. a keyword indicating that Snoopy mode 
should be terminated. This is the default. The 
“no” specification puts the terminal in Alpha 
mode. 


When the terminal is in Snoopy mode (but not in Setup 
mode) it displays control characters instead of execut- 
ing them. When the terminal is in Setup mode and . 
Snoopy mode at the same time, it displays the control 
character and then executes the control character. 


Since Snoopy mode displays characters which would 
otherwise be executed, it is a handy tool for debugging 
code. 


When in Snoopy mode, characters which are normally 
filtered out during communications to the host are not 
displayed. That means, for example, that even though 
the terminal is in Snoopy mode, the prompt string, 
block headers, and flagging characters are not 
displayed. 


The terminal displays control characters using the two- 
character abbreviation of control characters shown in 
the ASCII code chart (Appendix D). 


Snoopy mode can also be used to examine the 
contents of macros without executing any commands 
in them..To do so, first enter Setup mode and give the 
following command: 


SNOOPY yes pr 
After entering this command, exit from Setup mode and 
enter Local mode. Now when you press a key which 


has a macro assigned to it, that macro is displayed but 
not expanded. 


To de-activate snoopy, enter Setup mode and give the 
following command: 


SNOOPY no Cnr 
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SPOOL 


Copies data from one device to another, allowing the 
terminal to be used for other functions at the same 
time. 


[destination] 
[filename] 


SPOOL [source] to 
[filename] 


laniurcea-filanamal 


source indicates the source device. If no source 
is specified, the terminal defaults to disk drive O 
(FO:). Valid devices are: 


HO: host port 
FO: disk drive O (requires a filename) 


filename is an undelimited string of up to nine 
alphanumeric characters identifying the file to be 
copied. This filename must be specified if the 
“source” or “destination” is a disk. If a filename is 
specified as the destination, a file by that name is 
created on the disk. 


to is a keyword to indicate the flow of the status 
report -- from the “source” to the “destination.” 


destination indicates the destination device for 
the data being spooled. If no device is specified, 
the terminal defaults the disk drive. Valid devices 
are: 


HO: host port 

PO: peripheral port O 

P1: peripheral port 1 

P2: peripheral port 2 

FO: disk drive 0 (requires a filename) 
F1: disk drive 1 (requires a filename) 


Once initiated, the SPOOL operation proceeds in the 
background, allowing the terminal to be used for other 
operations. Data is transferred from the source to the 
destination without destroying the source copy. 


Spooling continues until: 

@ the terminal receives the end-of-file character 
@ the STOP command is issued 

@ there is a source or destination error 


REV, AUG 1981 6-47 


SETUP COMMANDS 


If the “destination” is a disk drive, an output error can 
result because: 


© There is no disk in the drive. 

© The disk in the drive is write protected. 

© The disk does not have enough room on it for the 
output file. 


if the last of these errors occurs, you should use a 
different disk. 
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If the source is the host, you should either arrange for 
the data to be transmitted for the SPOOL before you 
enter Setup mode, or be aware that after you issue the 
command everything that comes from the host is 
considered data, including the remote character echo. 


All characters echoed from the host either before the 
data stream begins or while the data stream is flowing 
are sent to the destination device. 


This command copies “‘file1’’ on disk drive O to the 
output device attached to peripheral port 2: 


SPOOL FO:filel to P2: °r 
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STATUS 


Reports the terminal's general status, the status of a 
group of related parameters or the setting of an 
individual terminal parameter. 


STATUS [cluster] 
[command] 
[command-abbreviation] 


If no parameter is entered, the terminal displays a 
general report of the terminal's status. 


cluster is an undelimited alphabetic string speci- 
fying a status report of a group of related 
parameters. Valid clusters are: 


report/input 

general 

communications 

optional (optional communications) 
dialog (dialog area) 

SPPI 


command is an undelimited alphabetic string 
specifying a command for which the terminal 
should report the status. Valid command names 
include all commands whose parameters are 
stored in the auxiliary backup memory. 


command-abbreviation is an undelimited al- 
phabetic string specifying one command ora 
group of commands ail of which start with the 
given abbreviation. 


The following command generates a general report of 
the status of the terminal (Figure 6-6): 


STATUS Cnr 
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STATUS 
TERMINAL STATUS 


REPORT INPUT 
IN 
LETTERS 


GENERAL 
EDITCHARS 


DIALOG 
DABUFFER 
DACHARS 
DAINDEX 
DAL INES 


COMMUNICATIONS 
2408 2408 


OPTIONAL COMM 
DURLE X23 ch gats mh FULL 
BLOCKMODE NQ 
BHEADERS “HEADTX" “HE ADRS’ 


Esa 7888: 


Figure 6-6. The STATUS Report. 
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This command generates a report of the status of 
commands relating to the dialog area (Figure 6-7): 


STATUS DIALOG Cr 


This command causes the terminal to report the status 
of the BAUDRATE command (Figure 6-8): 


STATUS BAUDRATE “rn 


When you abbreviate the name of a command, the 
terminal reports the status of all commands with the 
same Spelling up to the letters you specified. For 
example, if you enter the following command the 
terminal reports the status of all commands beginning 
with the character ‘“E” (Figure 6-9): 


STATUS E Cn 


If you request a report for a command that is not stored 
in the terminal's setup memory, there is no response. 
The cursor moves to the next line and displays the 
Setup mode prompt (*). 


*STATUS DIALOG 
DIALOG 


86 
7 4 6 
G 


DAMODE...... REPLACE 


DAPOSITION 4,8 
| 
HO 


Figure 6-7. The Dialog Area STATUS Report. 


*STATUS BAUDRATE 


BAUDRATE veeee C4806 2408 
t 


Figure 6-8. The STATUS BAUDRATE Report. 


*STATUS E 
EDLTCHARS } i+ 44% 
ECHO 4 5.8% ae 
ERRORLEVEL 


EOMCHARS 


x 


Figure 6-9. The STATUS E Report. 
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STOP 


Halts the current “spooling” operation. 
STOP 


Wtien a spool is halted, the output file is closed and all 
data that has already been transferred is saved. 


The command is ignored if no spool is in progress. 
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STOPBITS 


Specifies the number of stop bits used at the end of 
each character transmited from the terminal. 


STOPBITS 


1 indicates that the terminal appends one stop 
bit. This is the factory default. 


2 indicates that terminal appends two stop bits. 


The purpose of the “stop bit” is to indicate the 
completion of the transmission of a data byte. 


The following command sets the terminal to transmit 
two stop bits at the end of each byte: 


STOPBITS 2 Crp 


This parameter may be set by an applications program 
on the host computer or by an initialization file on a 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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TBFILTER (Options 13/14) 


Specifies the time or distance between points entered 
per stroke when the graphics tablet is in use. 


TBFILTER device, distance, time 


device is an integer parameter indicating the 
graphic input device to which this filter specifica- 
tion applies. Valid graphics input (GIN) devices 
are: 


8 tablet for ‘locator’ function 
9 tablet for “pick” function 
10 tablet for “stroke” function 


distance is an integer parameter specifying the 
minimum distance the graphics cursor or pen 
must travel before another point is transmitted to 
the program. The valid range is from 0 to 4096. 
The default is 0. 


time is an integer parameter specifying the 
minimum number of milliseconds that elapse 
between successive points transmitted to the 
program. The valid range is from 0 to 65535. The 
default is O. 


The following command sets the graphics tablet to 
locate every 100th point every 100 milliseconds: 


TBFILTER 10 100 100 CR 
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TBHEADERCHARS 


Specifies the header and key characters used in 
graphics input reports. 


(Options 13/14) 


TBHEADERCHARS letters) 


{control} 


letters specifies the characters M, J, and O as 
the header characters. This is the default. 


control specifies the control characters (GS), 
(SUB), and (US) to be the header characters. 


This emulates the HEADER strap on the TEKTRONIX 
4953 Graphics Tablet control board found in 4010- 
family terminals. For more details see the description of 
the <set-tablet-status-strap> command in the 4110 
Series Command Reference Manual. 
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TBSIZE (Options 13/14) 
The graphic tablets included with Options 13 and 14 
have a‘slightly larger active area than the TEKTRONIX 
4953 and 4954 tablets used with earlier 4010-series 
Tektronix terminals. To emulate the earlier tablets more 
closely, the < set-tablet-size> command is included 
in versions 2 and above of the firmware for Options 13 
and 14. 


TBSIZE {large} 
{small} 


{automatic} 


4110-series terminal. The active area of the 

1 Option 13 tablet is 121 square inches (11 in x 11 
in, or 279 mm x 279 mm). The active area of the 
Option 14 tablet is 1200 square inches (30 in x 
40 in, or 762 mm x 1016 mm). 


small is used when a smaller active area is 
required, to emulate more closely the 4953 and 
4954 tablets used with earlier Tektronix 4010- 
series terminals. The Option 13 tablet emulates 
the 4953 tablet, with an active area of 105 square 
inches (10.24 in x 10.24 in, or 260 mm x260 mm). 
The Option 14 tablet emulates the 4954 tablet, 
with an active area of 1180 square inches (30.72 
in x 38.4 in, or 780 mm x 975 mm). 


automatic is used when the tablet is enabled 
with an <enable-GIN> command from the host, 
the entire tablet area is used. When the tablet is 
enabled with the < enable-4953-tablet-GIN> 
command from the host, the smaller active area of 
the tablet is used, emulating the smaller active 
area of the 4953 and 4954 tablets. 


| large has the tablet operating as an option toa 


The following command sets the terminal to use the 
srnaller area of the 4953/4954 tablets. 


TBSIZESMALL Cr 
See the 4110 Host Programmer’s manual and the 4110 


Series Command Reference manual for detailed infor- 
mation concerning TBSIZE. 
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TBSTATUS (Options 13/14) 


Specifies whether or not the terminal status byte is 
sent when the graphics tablet pen is lifted away from 
the tablet surface. 


TBSTATUS {out} 
tin] 


out specifies that the status byte is not sent 
when the tablet pen is lifted away from the 
tablet surface. This is the default. 


in specifies that the status byte is sent when 
the tablet pen is lifted away from the tablet 
surface. 


This emulates the STATUS strap in the TEKTRONIX 
4953 Graphics Tablet board in 4010-style terminals. 
For more information, see the description of the < set- 
tablet-status-strap> command in the 4110 Series 
Command Reference Manual. 
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XMTDELAY 


Specifies the length of time for which transmission of 
data to the host is halted after the terminal encounters 
an end of message character (see EOMCHAR). 


XMTDELAY ms 


ms is an integer parameter representing the 
number of milliseconds delay in transmission. 


The acceptable range of values is from O to 
65535: the factory default is 100. 


XMTLIMIT 


Specifies the upper limit for data transmission from the 
terminal to a host computer. 
(Memory) 


XMTLIMIT limit 


limit is an integer parameter indicating the 
fastest rate at which the terminal is to send data 
to a host. The range of valid values is from 110 to 
65535; the factory default is 19200. 


The following command sets the transmit delay to 300 
milliseconds: 


XMTDELAY 300 Cnr 


This parameter may be set by an applications program 
on the host computer or by an initialization file ona 
flexible disk. If it is not, you may need to consult with a 
system programmer for your host computer before 
using this command. 
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IT tne nost computer cannot effectively receive data at 
the rate at which the communications port is specified, 
you can use XMTLIMIT to cause the terminal to pace 
its transmission of data at the given limit. This lowers 
the effective baud rate without altering the baud rate 
itself. 


The following command sets the transmit limit to 1800 
bits per second. 


XMTLIMIT 1800 Cnr 


This terminal operating parameter is host dependent. It 
should usually be set by an application program when 
it is executed from the host. If it is not, see a system 
programmer for your host computer for more informa- 
tion. See the 4110 Series Command Reference Manual 
for additional details. 
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ERROR CODES 


INTRODUCTION 


Each error condition which the terminal can detect has 
an “error code” and a “severity level.” 


When the terminal detects an error condition, it stores 
the error code in a limited-size queue for later retrieval 
by a <report-errors> command. 


If the error’s severity level is greater than or equal to 
the current error level, then the terminal displays a 
message for the operator. (The error level is deter- 
mined by the most recent ERRORLEVEL command.) 


SEVERITY LEVELS 


There are four severity levels, numbered from zero to 
three: ; 


@ Level 0. Errors of severity level zero are hardly 
errors at all. The associated message begins with 
the words “Terminal issues message ....” Typically, 
these errors occur for commands which are not 
installed. For instance, when 4112 commands are 


sent toa 4114, the terminal detects level zero errors. 


@ Level 1. Level one errors are “warnings.” The 
corresponding messages begin with the words “Ter- 
minal issues warning ....’ Typically these occur 
when the command is inappropriate: deleting a 
segment that does not exist, for example. 


@ Level 2. Level two errors result from invalid com- 
mands. For instance, a command's parameter may 
be outside the specified range. The corresponding 
message begins with the words, ‘‘Terminal detects 
error....” 


@ Level 3. Level three errors occur when the 
command is valid, but for some reason the terminal 
cannot execute the command. (For instance, there 
may be insufficient memory to hold all the informa- 
tion being included in a segment definition.) For 
these errors, the message starts with the words, 
“Terminal system error....” 
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COMMANDS NOT INSTALLED IN THE 
TERMINAL 


When the terminal receives an escape-sequence com- 
mand which it does not recognize, it detects the 
appropriate error message (of severity level zero}. After 
detecting the error, the terminal then ignores all 
subsequent characters until it receives an &c, Ss, Fs, or 
Us character. (It does this so as to skip over any 
parameters for the unrecognized command.) 


For instance, suppose the terminal does not have 
Option 1 installed, and the host sends it the following 
character sequence: 


&c(O)(D)(O)Ec(K)(A)(1) 


Since Option 1 is not installed, the terminal does not 
recognize the < set-duplex-mode: O> command, 
Ec(O)(D)(Q). On receiving the &c(O)(D) op code, the 
terminal detects a type ODOO error (and displays the 
ODOO error message if the error threshold is set to 
zero). It ignores the following character, (0). On receiv- 
ing the following &c, the terminal resumes processing of 
the characters received, so that it correctly interprets 
and executes the < enable-dialog-area: 1> command, 
Eo(K)(A)(1). 


if your host program sends commands which may not 
be installed in all 4110-series terminals, then it should 
follow those commands with other commands which 
are recognized by all terminals in the series. For 
instance, after issuing commands to change 41 12-only 
settings, the host could send a Ys character (the 
<enter-alpha-mode> command) before sending any 
alphatext to the terminal. That way, if the terminal is a 
4114 rather than a 4112, the 's character causes the 
terminal to resume normal processing of the characters 
it receives. 
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ERROR CODES 


The error codes are each composed according to the 
following scheme: 


@ Each error code consists of four characters. 


® In most error codes, the first two characters are the 
op code for some command: the command being 
executed when the error is detected. For example, 
error |A11 is associated with the PICKAPERTURE 
command. 


Some errors, however, are associated with no parti- 
cular command. For these errors, the first two 
characters are a letter and a digit. For instance, error 
1011 (invalid device-function code) can occur with 
many graphic input commands. Again, error J109 
(disk hardware initialization error) can occur only 
when the terminal is turned on, before any com- 
mands have been sent to it. 


® The third character in an error code is a numeric 
digit. Digits from 1 to 9 name the parameter with 
which the error is associated. Digit 0 indicates that 
the error is associated with the command as a 
whole: the op code itself is regarded as the ‘‘zeroeth 
parameter.” 


®@ The fourth character in an error code is also a digit. 
The most frequently used digits here are 0, 1, 2, and 
3: 


0: Indicates an “existence problem.” The object 
referred to does not exist when it ought to exist, 
or does exist when it ought not to exist. 


1: Indicates an “invalid value.” 
2: Indicates an “out of memory problem.” 


3: A “context error.” The command is valid, but 
cannot be executed at this time. (For instance, 
trying to end a segment when no segment is 
currently being defined.) 


For example, consider the ‘JD10” error code. Here, 
“JD" means the DIRECTORY command. The ‘‘1” refers 
to the first parameter of that command, which is the 
device. The “0” indicates an “existence problem,” 
there is no such device. 
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DISK HARDWARE ERRORS 


For some disk system errors (‘type 9” errors such as 
JC19, JC39, JD19, etc.), the error code reports a “disk 
hardware error number.” Table A-1 lists the disk 
hardware errors: 

Table A-1 


DISK HARDWARE ERRORS 


Error Number Explanation 


= 


Cannot complete result phase. 
Cannot sense drive status. 
Cannot sense interrupt status. 
RQM wrong State. 

(Reserved) 

(Reserved) 

Invalid command. 

Bad track. 


Control mark. 


oO wmnon Oo a F&F WO DN 


ie) 


CRC (cyclic reduncy check) 
error. 


= 
= 


Missing address data. 


as 
ie) 


Missing address mark. 
No data. 
Wrong cylinder. 


ee ee 
na PF WwW 


Overrun. 


= 
fo] 


(Reserved,) 


— 
N 


Not two-sided. 


oo 


Failed command phase (bytes 
not output). 


DISK SYSTEM CONTEXT ERRORS 


For some disk system errors (“type 3” errors such as 
JC13, JC33, JD33, etc.), a supplemental error message 
may be displayed. This supplemental message 
describes the type of ‘context error” which has 
occurred. Table A-2 lists these context error types: 
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Error 


File Already Open 


No FCB 


Secure Volume 


The remainder of this appendix lists the specific error 
codes. They are listed alphabetically, according to the 
op code associated with each command. 


Table A-2 
DISK SYSTEM CONTEXT ERROR 


Explanation 


Tried to open for input a file 
which is already open for out- 

put; or, tried to open for output 
a file which is already open for 
input. 


Directory Full 


File Not Open 


No File Control Block is avail- 
able when opening a file; or, 
the File Control Block has 
been destroyed. 


File Trailer Error 


A “secure volume” is a disk- 
ette (usually holding proprieta- 
ry software) which cannot be 
copied. (However, files can be 
<load> ed from a secure vol- 
ume, and a directory can be 
obtained with the <directory> 
command. 


Directory Update Error 


Transfer Direction Error 


ERROR CODES 


Explanation 


This diskette already contains 
the maximum number of files 
for which it was formatted. 


Tried to.close a file which is 
not currently open. 


Unsuccessful attempt to 
terminate the writing of a file. 
(The file being written be- 
comes inaccessible.) 


Error in attempting to update 
the disk directory on the disk- 
ette. 


Tried to read from a file which 
was opened for output; or, tried 
to write to a file which was 
opened for input. 


ERROR CODES 


NOTE 


Ec may appear as (ESC) in other manuals. How- 
ever, in this manual, it is shown as €c. 


If the command has an English-like Setup mode 
equivalent, it is indicated. If there is not, only the 
escape sequence format for the command is shown. 


10 (For several GIN commands.) 
1002 (Level 2): Insufficient memory available for GIN functions. 


1011 (Level 2): Invalid device-function code. (See the description of the <enable-GIN> command for a table of 
device-function codes.) 


11 < Enable-4953-Tablet-GIN> 
< Disable-4953-Tablet-GIN> = £c(I)(!)< ASCIl-char> 


1100 (Level 2): Unrecognized command (Option 13 or 14 not installed). 


IA PICKAPERTURE=< Set-Pick-Aperture> = c(I)(A)<int> 
1A11 (Level 1): Invalid aperture width (must not be in the range from 0 to 4095). 
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A-4 


< Set-GIN-Cursor> =®c(I)(C)<int><int> 
(Level 2): Graphic input has already been enabled for the specified device-function code. 
(Level 2): Segment does not exist, or is currently being defined. 


(Level 2): Invalid segment number (must be in the range O to 32767). 


<Enable-GIN> = c(I)(E)< int> <int+> 


(Level 2): the cursor segment for the specified device-function code does not exist. (It has been deleted 
since the < set-GIN-cursor> command which assigned it to that device-function code.) 


(Level 2): Command is invalid at this time. (The segment being used as the cursor for the specified device- 
function code is a segment which is currently being defined.) 


(Level 2): The specified GIN device is not installed in the terminal. 
(Level 2): The specified device is already enabled. 
(Level 2): Invalid number of GIN events (must be in the range from 1 to 65535). 


TBFILTER=< set-GIN-Stroke-Filtering> =€c(I)(F)<int> <int> <int> 
(Level 2): Unrecognized command. (The tablet option is not installed.) 


(Level 2): Stroke filtering does not apply to the specified device-function code. (Stroke filtering applies only 
to the stroke function on the tablet device.) 


(Level 2): Invalid filtering distance (must be in the range from 0 to 4095). 
(Level 2): Invalid filtering time (must be in the range from O to 32767). 


GRIDDING=< Set-GIN-Gridding> =c(I)(G)<int> <int> <int> 


(Level 2): Gridding does not apply to the specified device-function code. (Gridding is not allowed for the 
stroke function.) 


(Level 2): Invalid x-spacing (must be in the range from 0 to 4095). 
(Level 2): Invalid y-spacing (must be in the range from 0 to 4095). 


TBHEADERCHARS=< Set-Tablet-Header-Characters > =c(I)(H) < int> <int> 
(Level 0): Unrecognized command. (Tablet option is not installed.) 
(Level 2): Invalid parameter (must be 0 or 1; in Setup mode, must be CONTROL or LETTERS). 


< Set-GIN-Inking> =€c(1)(I)<int> <int> 


(Level 2): Inking does not apply to the specified device-function code. (Inking is not allowed for the pick 
function.) 


(Level 2): Invalid Inking mode (must be 0 or 1). 

< Set-Report-Max-Line-Length> =®c(I)(L)<int> 

(Level 2): Invalid maximum report line length (must be in the range from 0 to 65535). 
REOM=< Set-Report-EOM-Frequency> = c(I)(M)<int> 

(Level 2): Invalid report-EOM-frequency setting (must be 0 or 1). 


< Set-Tablet-Mode> = —c (IN)<int-array> 


(Level 0): The <set-tablet-mode> command is not installed. (This command requires version 2 or above of 
the Option 13 or 14 firmware.) 


(Level 2): Invalid parameter. (Must be O, 1, or 2.) 
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IP < Report-GIN-Point> =&c(I)(P)<int> 

IP13 (Level 2): The device-function code names a device which has already been enabled for a different graphic 
input function. 

1Q < Report-Terminal-Settings > =®c(I)(Q) < char> <char> 


No errors are detected for this command. 


IR < Set-GIN-Rubberbanding> =®c(I)(R)<int> <int> 


IR10 (Level 2): Rubberbanding does not apply to the specified device-function code. (Rubberbanding is only 
allowed for the locator function. It is forbidden for the pick and stroke functions) 


IR21 (Level 2): Invalid Rubberbanding mode (must be O or 1), 


Is < Set-Report-Sig-Chars> =®c(I)(S)<int> <char:> <char> 

IS11 (Level 2): Invalid report type code (must be valid device-function code, or in the range from —1 to —3). 
IS21 (Level 2): Invalid second parameter (must be in the range from 0 to 127). 

IS31 (Level 2): Invalid third parameter (must be in the range from O to 127). 


IT TBSTATUS=< Set-Tablet-Status-Strap > =®c(1)(T)<int> 

ITOO (Level 0): Unrecognized command. (The tablet option is not installed.) 
IT11 (Level 2): Invalid strap setting (must be O or 1). 

JO and J1: Disk System Errors on Power-Up 

JOO2 (Level 3): Memory error detected by standard firmware. 

J102 (Level 3): Memory error detected by optional peripheral firmware. 
J109 (Level 3): Hardware initialization error in Disk Controller board. 


JC  COPY=< Copy> = c(J)(C) <string> <string> <string> 
JCO3 (Level 2): 
JC10 (Level 2): 
JC11 (Level 2): Invatid source device specifier. 
JC12 (Level 3): 


Attempt to copy an entire disk volume onto itself (e.g., a copy from FO: to FO:). 


Specified source device does not exist. 


Parameter 1 memory error. (Out of memory while parsing the first parameter, or while executing 
the command, 


JC13 ) 

JC19 ) 

JC21 (Level 2): Invalid separator string (must be empty string or “TO"). 
) 


(Level 2): 
( 
( 
JC22 (Level 3): 
{ 
{ 
( 


Parameter 1 context error (not an input device). 


Disk hardware error or drive not ready ori the source disk drive. 


Parameter 2 memory error. (Out of memory while parsing the separator string.) 
JC30 
JC31 
JC32 


Level 2): Specified destination device does not exist. 
Level 2): Invalid destination specifier. 


Level 3): Parameter 3 memory error. (Out of memory while parsing the third parameter, or while executing 
the command.) 


JC33 (Level 2): Parameter 3 context error (not a valid destination device), 

JC39 (Level 2): Disk hardware error or drive not ready on the destination diskdrive. 
JE STOP=< Stop-Spooling> = c(I)(T) 

No errors are detected for this command. 
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ERROR CODES 


JD 

JDOO 
JD10 
JD11 
JD12 


JD13 
JD19 
JD21 
JD22 
JD30 
JD31 
JD32 


JD33 


JD39 


JF 

JFOO 
JF1O 
JF11 
JF12 
JF13 


JF1I9 


JK 

JKOO 
JK10 
JK11 
JK12 
JK13 
JK19 


A-6 


DIRECTORY=< Directory> =c(J)(D) <string> <string> <string> 


(Level 2): 
(Level 2): 
(Level 2): 
(Level 3): 


(Level 2): 
(Level 2): 
(Level 2): 
(Level 3): 
(Level 2): 
(Level 2): 
(Level 3): 


{Level 2): 


(Level 2): 


Unrecognized command. (Disk drive option is not installed.) 
The device for which the directory is requested does not exist. 
Invalid input device specifier in parameter 1. 


Parameter 1 memory error. (Out of memory while parsing the source string, or while executing the 
command.) 


Context error in parameter 1. (The specified device is not a disk drive, or failed reading bit map,) 
Disk hardware error (or drive not ready) for the disk drive whose directory is being requested. 
Invalid separator string (must be empty string or TO’). 

Parameter 2 memory error. (Out of memory while parsing the separator string.) 

The specified destination device does not exist. 

Invalid destination device specifier. 


Parameter 3 memory error. (Out of memory while parsing the destination string, or while executing 
the command.) 


Parameter 3 context error. (The device specified is not a valid destination device, or is write- 
protected) 


Disk hardware error for the destination device. (I/O error, write-protect error, or disk drive not 
ready.) 


FORMAT=< Format-Volume> =®c(J)(F) <string> <int> 


(Level 2): 
(Level 2): 
(Level 2): 
(Level 3): 
(Level 2): 


(Level 2): 


Unrecognized command. (Disk drive option not installed.) 

Device does not exist or is not installed. 

Invalid device specifier. 

Parameter 1 memory error. (Out of memory while parsing the device specifier string.) 


The device specified in parameter 1 (a) is not a disk drive, (b) is write protected, (c) is busy, (d) 
detects a verify error, or (e) detects a bit map error. 


Hardware error at the specified disk drive. (Format error, drive not ready, or write-protect switch or 
notch error.) 


DELETE=< Delete-File> =®c(J)(K)< string> 


{Level 2): 
(Level 2): 
(Level 2): 
(Level 3): 
(Level 2): 
(Level 2): 


Unrecognized command. (Disk drive option is not installed.) 

The specified file or disk drive does not exist. 

Invalid device specifier. 

Parameter 1 memory error. (Out of memory while parsing parameter 1.) 

The specified device (a) is not a disk drive, (b)is write-protected, or (c) detects a bit map error. 


Disk hardware error. (I/O error, drive not ready, or hardware write-protect error.) 
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JL 

JLO2 
JLO3 
JL10 
JL14 
JL12 


JL13 
JL19 


JP 

JPOO 
JP10 
JP11 
JP12 
JP13 


JP19 
JP21 


JQ 

JQOO 
JQ10 
JQ11 
JQ12 


JR 

JROO 
JR10 
JR11 
JR12 
JR13 


JR19 
JR21 
JR22 
JR30 
JR31 
JR32 


ERROR CODES 


LOAD=< Load> =®c(J)(L)< string> 
Level 3): Out of memory while performing <load> command. 
Level 2): Nesting error. (< Load> commands are nested too deeply.) 


( 
( 
(Level 2): File or device does not exist. 
(Level 2): Invalid file specifier. 

( 


Level 3): Parameter 1 memory error. (Out of memory while parsing parameter 1, or while executing the 
command.) 


(Level 2): Context error in parameter 1. (Not a valid source device) 
(Level 2): Disk hardware error or drive not ready. 


PROTECT=< Protect-File> =£c(J)(P)< string> <int> 
Level 2): Unrecognized command. (Disk drive option is not installed.) 
Level 2): The specified file or disk drive does not exist. 


( 

( 

(Level 2): Invalid file specifier. 

{Level 3): Parameter 1 memory error. (Out of memory while parsing parameter 1.) 
{ 


Level 2): Either the specified device is not a disk drive, or the file (or entire diskette volume) has been write- 
protected. 


(Level 2): Disk hardware error. {I/O error, drive not ready, or hardware write-protect error.) 
(Level 2): Invalid Protection mode (must be O or 1). 


< Report-Device-Status> = c(J)}(Q)< string> 

(Level 2): Unrecognized command. (Disk drive option is not installed.) 
(Level 2): Device does not exist or is not installed. 

(Level 2): Invalid device specifier. 
( 


Level 3): Parameter 1 memory error. (Out of memory while parsing parameter 1.) 
RENAME=< Rename-File> =®c(J)(R)< string> <string> <string> 

Level 2): Unrecognized command. (Disk drive option is not installed.) 

Level 2): The specified device or file does not exist. 


( 

( 

{Level 2): Invalid “old” file specifier. 

(Level 3): Parameter 1 memory error. (Qut of memory while parsing parameter 1.) 
( 


Level 2): Either the device specified in parameter 1 is not a disk drive, or the file (or entire diskette) has 
been write-protected. 


Level 2): Disk hardware error. (I/O error, drive not ready, or hardware write-protect error.) 


Level 2): Invalid separator string (must be empty string or “TO"). 


Level 2): Either the device specified in parameter 3 does not exist, or the ‘‘new” filename already is in use. 


Level 2 


( ): 
( ys 
(Level 3): Parameter 2 memory error. (Out of memory while parsing parameter 2.) 
( ): 
( ): Invalid device specifier in parameter 3. 

( ): 


Level 3): Parameter 3 memory error. (Out of memory while parsing parameter 3)) 


4112 OPERATOR'S A-7 


ERROR CODES 


JS SPOOL=< Spool> = c(J)(S)<string> <string> <string> 
JSO3 (Level! 2): Command context error. (A spooling operation is already in progress.) 
JS10 (Level 2): Specified source device does not exist. 


JS11 (Level 2): Invalid source specifier. (Must be “HO:”, “PO:”, “P1:”, “P2:”, or a file specifier such as “FO: 
FILENAME”. Specifying only the disk drive — such as “FO:” or “F1:" — is not allowed.) 


JS12 (Level 3): Parameter 1 memory error. (Out of memory while parsing parameter 1, or while executing the 
command.) 


J513 (Level 2): Parameter 3 context error. (Not a valid input device.) 

JS19 (Level 2): Disk hardware error or drive not ready on the source disk drive. 

J521 (Level 2): Invalid separator string (must be empty string or “TO"). 

JS22 (Level 3): Parameter 2 memory error. (Out of memory while parsing parameter 2.) 
JS30 ( 

JS31 (Level 2}: Invalid destination device specifier. 
JS32 ( 


Level 2): Specified destination device does not exist. 


Level 3): Parameter 3 memory error. (Out of memory while parsing parameter 3, or while executing the 
command.) 


JS33 (Level 2): Parameter 3 context error. (Not a valid destination device.) 


JS39 (Level 2): Disk hardware error or drive not ready on the destination disk drive. 


JV SAVE=< Save> ='c(J)(V)< string> <int> <string> <string> 
JV11 (Level 2): invalid type-of-save string. (Must be MAC or SEG) 


JV12 (Level 3): Parameter 1 memory error. (Out of memory while parsing paramter 1, or while executing the 
command.) 


JV20 (Level 2): The specified macro definition or segment does not exist. 

JV21 (Level 2): Invalid item number or count. 

JV31 (Level 2): Invalid separator string (must be empty string or “TO"). 

JV32 (Level 3): Parameter 3 memory error. (Out of memory while parsing the separator string.) 
JV40 (Level 2): The specified destination device does not exist. 

JV41 (Level 2): Invalid destination device specifier. 


JV42 (Level 3): Parameter 4 memory error. (Out of memory while parsing the destination string, or while executing 
the command.) 


JV43 (Level 2): Parameter 4 context error. (Not a valid destination device.) 


JV49 (Level 2): Disk hardware error on destination disk drive (I/O error, drive not ready, or hardware write-protect 
error). 


KO : Keyboard System Errors 
KO (Level 3): Out of memory while initializing the keyboard system. 


KA OAENABLE=< Enable-Dialog-Area> =§c(K)(A)<int> 
KA11 (Level 2): Parameter out of range (must be O or 1). 


KC <Cancel> = c(K)(C) 


No errors are detected for this command. 
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ERROR CODES 


KD DEFINE=< Define-Macro> =*c(K)(D)<int> <int-array> 
KD11 (Level 2): Invalid macro number (must be in range —1 to 32767). 


KD21 (Level 2): Invalid character-code in <int-array>. (Character codes must be in the range from O to 127. The 
array count must be in the range from 0 to 65535.) 


KD22 (Level 3): Insufficient memory to define macro. 


KE  ECHO=< Echo> = c(K)(E)<int> 
KE11 (Level 2): Invalid Echo mode (must be O or 1). 


KF LFCR=< LFCR> = c(K)(F)<int> 
KF11 (Level 2): Invalid LECR mode (must be O or 1). 


KH <Hardcopy> =*c(K)(H)<int> 

KH11 (Level 2): Invalid hardcopy code (must be 0, 1, or 2). 

KI IGNOREDEL=< Ignore-Deletes> =€c(K) (I) < int> 

Kl11 (Level 2): Invalid Ignore-Deletes mode (must be 0 or 1). 

KL LOCKKEYBOARD=< Lock-Keyboard > = c(K)(L)< int> 
KL11 (Level 2): Invalid Keyboard-Lock mode (must be © or 1). 
KN RENEW=< Renew-View> ="c(K)(N)<int> 


KN11 (Level 2): Parameter out of range (must be in the range from —32768 to + 32767). (This parameter should 
be in the range from —1 to 64; however, the terminal will substitute —1 in place of a value which is 
less than —1, and + 64 in place of a value in the range from 65 to 32767.) 


KP PAGEFULL=< Set-Page-Full-Action> =®c(K)(P)<int> 
KP11 (Level 2): Invalid page-full-action code (must be in the range from 0 to 7). 


KQ = <Report-Errors> =£c(K)(Q) 


No errors are detected for this command. 

KR CRLF=< CRLF> =*c(K)(R)<int> 

KR11 (Level 2): Invalid “CR-implies-LF” mode (must be O or 1). 
KS SNOOPY=< Snoopy> =€c(K)(S)< int> 

KS11 (Level 2): Invalid parameter (must be O or 1). 

KT ERRORLEVEL=< Set-Error- Threshold > =§c(K)(T)< int> 


KT11 (Level 2): Invalid error threshold (must be in range from 0 to 4). 
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ERROR CODES 


KX 


KX01 


KX02 
KX11 
KY 
KY11 
KZ 
K2Z11 
KZ21 
KZ31 
LB 
LB11 
Lc 
LC11 
LE 
LEOO 
LEO3 
LEOQ2 
LF 


<Expand-Macro> =£c(K)(X)<int> 


(Level 2): The maximum nesting depth (for <expand-macro> and <load> commands) has been exceeded. 
(The nesting depth should not exceed five. Greater nesting depths may result — but do not 
necessarily result — in type KX01 errors.) 


(Level 3): Out of memory while performing <expand-macro> command. 

(Level 2): Invalid macro identifier (must be in the range from 0 to 32767). 
KEYEXCHAR=< Set-Execute-Toggle-Char> =c(K)(Y)<int> 

(Level 2): Invalid <key-execute-toggie> code (must be in range O to 127). 
EDITCHARS=< Set-Edit-Chars> =®c(K)(Z)<int> <int> <int 

(Level 2): Invalid char-delete character (must be in the range from 0 to 127). 

(Level 2): Invalid line-delete character (must be in the range from 0 to 127). 

(Level 2): Invalid take-literally character (must be in the range from 0 to 127). 
DABUFFER=< Set-Dialog-Area-Buffer-Size> =®c(L)(B)< <int+> 

(Level 2): Invalid number-of-lines parameter (must be in the range from 2 to 65535). 
DACHARS=< Set-Dialog-Area-Chars > =®c(L)(C) < int+> 

(Level 2): Invalid number of characters per line (must be in the range from 5 to 819). 
<End-Panei> =®c(L) (E) 

(Level 0): Unrecognized command. (The terminal is not a 4112) 

(Level 1): No panel is currently being defined. 

(Level 3): Out of memory while performing < end-panel> command. 


< Move> = c(L)(F)< xy> 


No errors are detected for this command. 


LG 


< Draw> =®c(L)(G)< xy> 


No errors are detected for this command. 


LH 


< Draw-Marker> =§c(L)(H)< xy> 


No errors are detected for this command. 


LI 
LIOO 
Li11 
L121 
L131 


DAINDEX=< Set-Dialog-Area-Index> = c(L)(I)<int+> <int+> <int+> 

(Level 0): Unrecognized command. (The terminal is not a 4112) 

(Level 2): Invalid character index (must be in the range from O to 65535). 

(Level 2): Invalid character background index (must be in the range from 0 to 65535). 


(Level 2): Invalid dialog area wipe index (must be in the range from 0 to 65535). 
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LK 


LKO2 


LK10 


LK11 


LL 


LL11 


LM 


LM11 


LP 


LPOO 


LP21 


LS 


LSOO 


L510 


L811 


LT 


LT114 


LT12 


LV 


LVO3 


LV11 


LX 


<Include-Copy-of-Segment> =c(L)(K) <int> 

(Level 3): Out of memory while performing <include-copy-of-segment>. 
(Level 2): Segment does not exist. 

(Level 2): Invalid segment number (must be —3, --1, or in the range from 1 to 32767)) 
DALINES=< Set-Dialog-Area-Lines> =c(L)(L)< int+> 

(Level 2): Invalid parameter (must be in the range from 2 to 520). 
DAMODE=< Set-Dialog-Area-Writing-Mode> ="c(L)(M)< int> 

(Level 2): Invalid Writing mode (must be 0 or 1). 

< Begin-Panel-Boundary > ==c(L)(P)< xy> <int> 

(Level 0): Unrecognized command. (Terminal is not a 4112.) 

(Level 2): Invalid ‘draw border’ mode (must be 0 or 1). 

< Set-Dialog-Area-Surface> =c(L)(S)<int> 

(Level 0): Unrecognized command. (The terminal is not a 4112) 

(Level 2): Surface does not exist. 

(Level 2): Invalid surface number (must be 1, 2, ar 3). 


< Graphic-Text> =®c(L)(T) < string> 


ERROR CODES 


(Level 2): Invalid graphtext string. Invalid array count (must be in the range from 0 to 32767), or invalid 
<char> character in the array (must be in the range from ADE value 26 [space] to 126 [tildal). 


(Level 3): Parameter 1 memory error. (Out of memory while parsing the <string> parameter.) 


DAVIS=< Set-Dialog-Area-Visibility> ="c(L)(V)<int> 


(Level 0): One or more of the dialog area parameters was altered when the dialog area was made visible. 


(Level 2): Invalid dialog area visibility mode. (Must be O or 1; in Setup mode, must be YES or NO.) 


DAPOSITION=< Set-Dialog-Area-Position> = c(L)(X)< xy> 


No errors are detected for this command. 


LZ 


< Clear-Dialog-Scroll> =*c(L)(Z) 


No errors are detected for this command. 
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ERROR CODES 


MC  <Set-Graphtext-Size> ='c(M)(C)<int> <int> <int> 

MC11 (Level 2): Invalid value in parameter 1 (must be in the range from 1 to 4095). 
MC21 (Level 2): invalid value in parameter 2 (must be in the range from 1 to 4095). 
MC31 (Level 2): Invalid value in parameter 3 (must be in the range from 0 to 4095). 
MD <Begin-Fill-Pattern> = c(M)(D)<int> <int> <int> <int> 

MDOO (Level 0): Unrecognized command. (The terminal is not a 4112) 

MDO2 (Level 3): Not enough memory available for fill pattern. 

MD11 (Level 2): Invalid fill pattern number (must be in the range from 1 to 32767). 
MD21 (Level 2): Invalid pattern width (must be in the range 1 to 32). 

MD31 (Level 2): Invalid pattern height (must be in the range O to 480). 

MD41 (Level 2): Invalid bits-per-pixel (must be 1, 2, 3, or 6). 


ME <End-Fill-Pattern> ==c(M)(E) 


No errors are detected for this command. 

MF <Set-Graphtext-Font> =&c(M)(F)<int> 

MF10 (Level 2): Font does not exist. 

MF11 (Level 2): Invalid font number (must be in the range 0 to 32767), 

MG GAMODE=< Set-Graphics-Area-Writing-Mode> = c(M)(G)< int> 

MGOO (Level 2): Unrecognized command. (Terminal is not a 4112.) 

MG11 (Level 2): Invalid parameter (must be O or 1; in SETUP mode, must be OVERSTRIKE or REPLACE), 
MI < Set-Pick-ID> =&c(M) (I) << int> 

MIO3 (Level 2): Command is invalid at this time (no segment is currently being defined). 
Ml11 (Level 2): Invalid pick identification number (must be in the range from 0 to 32767), 
ML <Set-Line-Index> =®c(M)(L)<int+> 

ML11 (Level 2): Invalid line index (must be in the range from 0 to 32767). 

MM <Set-Marker-Type> = c(M)(M)<int> 


MM11 (Level 2): Invalid marker type (must be in the range from 0 to 10). 
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MP 
MPOO 
MP10 
MP11 
MQ 
MQ11 
MR 
MR11 
MS 
MSOO 
M311 
MS21 
MS31 
MT 
MT114 
MV 
MV11 
NB 
NB11 
NC 
NCt1 
NC21 
ND 
NOD11 
NE 


NEt4 


NE12 


ERROR CODES 


< Select-Fill-Pattern> =&c(M)(P)<int> 

(Level 2): Unrecognized command (terminal is not a 4112). 

(Level 2): Specified fill pattern does not exist (has not been defined). 

{Level 2): Invalid fill pattern number (must be in the range from —32768 to 32767). 
< Set-Graphtext-Precision> ==c(M)(Q)<int> 

{Level 2): Invalid Precision mode (must be 1 or 2). 

< Set-Graphtext-Rotation> =£c(M)(R)< real> 

(Level 2): Invalid rotation angle (must be in the range from —32767.0 to + 32767.0). 
< Set-Panel-Filling- Mode> =&c(M)(S)<int> <int> <int> 

(Level 2): Unrecognized command. (Terminal is not a 4112) 

(Level 2): Invalid overstrike/replace mode parameter (must be O or 1). 

(Level 2): Invalid boundary-filling mode parameter (must be 0 or 1). 

(Level 2): Invalid pattern keying value (must be O, 1, 2, or 3). 

< Set-Text-Index> =c(M)(T)< int+> 

(Level 2): Invalid text index (must be in the range from O to 65535). 

< Set-Line-Style> =®c(M)(V)<int> 

(Level 2): Invalid line style (must be in the range from QO to 7). 

STOPBITS=< Set-Stop-Bits > =®c(N)(B)<int> 

(Level 2): Invalid number of stop bits (must be 1 or 2). 

EOMCHARS=< Set-EOM-Chars > ==c(N)(C) <int> <int> 

(Level 2): Invalid value in parameter 1 (must be in the range from O to 127). 
(Level 2): Invalid value in parameter 2 (must be in the range from 0 to 127). 
XMTDELAY=< Set-Transmit-Delay > =®c(N)(D) <int> 

(Level 2): Invalid transmit delay time (must be in the range from O to 65535 ms). 
EOFSTRING=< Set-EOF-String> =c(N)(E)< int-array> 


(Level 2): Invalid EOF-string (must contain from 0 to 10 characters, with each character represented by an 
<int> in the range from 0 to 127). 


(Level 3): Parameter 1 memory error (out of memory while parsing the <int-array> parameter). 
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ERROR CODES 


NF 


NF11 


NK 


NK11 


NL 


NL11 


NM 


NM11 


NP 


NP1 1 


NQ 


NQO2 


NQ11 


NR 


NR11 


NR24 


NS 


NS11 


NS12 


NT 


NT11 


NT12 


NU 


NU11 


FLAGGING=< Set-Flagging-Mode> = c(N) (F)<int> 

(Level 2): Invalid Flagging mode (must be in the range from 0 to 4). 
BREAKTIME=< Set-Break-Time> =c(N)(K)< int+> 

(Level 2): Invalid parameter. (Must be in the range from 0 to 65535.) 
XMTLIMIT=< Set-Transmit-Rate-Limit > ="c(N)(L)< int+> 

(Level 2): Invalid transmit rate limit. (Must be in the range from 110 to 65535,) 
PROMPTMODE=< Prompt-Mode> =®c(N)(M) < int> 

eval 2): Invalid Prompt mode parameter (must be 0, j,0r 2). 

PARITY=< Set-Parity > ="c(N)(P)<int> 

(Level 2): Invalid parity code (must be in the range from 0 to 4). 
QUEUESIZE < Set-Queue-Size> = c(N)(Q)< int+> 

(Level 3): Out of memory while performing <set-queue-size> command. 
(Level 2): Invalid queue size (must be in the range from 1 to 65535). 
BAUDRATE=< Set-Baud-Rates > =*c(N)(R)<int+> <int+> 


(Level 2): Invalid transmit (terminal-to-host) data rate (must be 1, 50, 75, 110, 134, 150, 300, 600, 1200, 
1200, 1800, 2000, 2400, 4800, 9600, 19200, or 38400). 


(Level 2): Invalid receive (host-to-terminal) data rate (must be 0, 1, 50, 75, 110, 134, 150, 300, 600, 1200, 
1800, 2000, 2400, 4800, 9600, 19200, or 38400). 


PROMPTSTRING=< Set-Prompt-String> =&c(N)(S)<int-array> 


(Level 2): Invalid <int-array> parameter. (Must be an array holding from 0 to 10 <int> parameters. Each of 
the items in the array must be an <int> in the range from 0 to 127,) 


(Level 3): Parameter 1 memory error. (Out of memory while parsing the <int-array>. 
EOLSTRING=< Set-Term-String> =®c(N)(T)< int-array> 


(Level 2): Invalid array count in <int-array>. (The array must hold from 0 to 2 <int> parameters. Each 
<int> in the array must be in the range from 0 to 127,) 


(Level 3}: Parameter 1 memory error. (Out of memory while parsing the <int-array> parameter.) 
BYPASSCANCEL=< Set-Bypass-Cancel-Char> =®c(N)(U)<int> 


(Level 2): Invalid numeric equivalent of bypass-cancel character (must be in the range from 0 to 127). 
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oB 


OBOO 


OBO03 


OB11 


oc 


Ocoo 


OC03 


0C11 


0C21 


OD 


ODOO 


ODO1 


OE 


OEOO 


OE03 


OE11 


OE21 


OH 


OHOO 


OHO2 


OHO3 


OH11 


OH12 


OH21 


OH22 


ERROR CODES 


BLOCKMODE=< Arm-For-Block-Mode> =*c(O)(B)< int> 

(Level 2): Unrecognized command. (Option 1 is not installed.) 

(Level 2): The communications queue size is smaller than the specified input block size. 

(Level 2): Invalid “arm-for-block-mode” parameter (must be 0 or 1). 

BCONTINUECHARS=< Set-Block-Continue-Chars > = c(O)(C)<int> <int> 

(Level 2): Unrecognized command. (Option 1 is not installed.) 

(Level 2): Command is invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
(Level 2): Invalid first parameter (must be in the range from 0 to 127). 

(Level 2): Invalid second parameter (must be in the range from O to 127). 

DUPLEX=< Set-Duplex-Mode> =*c(O)(D)<int> 

(Level 2): Unrecognized command. (Option 1 is not installed.) 

(Level 2): Invalid duplex mode code (must be in range 0 to 3). 

BENDCHARS=< Set-Block-End-Chars > =§c(O)(E)<int> <int> 

(Level 2): Unrecognized commana. (Option 1 is not installed.) 

(Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
(Level 2): invalid first parameter (must be in the range from 0 to 127). 

(Level 2): Invalid second parameter (must be in the range from 0 to 127). 

BHEADERS=< Set-Block-Headers > =*c(O)(H) < int-array> <int-array> 

(Level 2): Unrecognized command. (Option 1 is not installed.) 

(Level 3): Out of memory while performing < set-block-headers> command. 

(Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 


(Level 2): Invalid character code (0 to 127) or array count (must be in range O to 10) in “transmit” (terminal- 
to-host) block header. 


(Level 3): Parameter 1 memory error. (Out of memory while parsing the <int-array> |) 


(Level 2): Invalid character code (O to 127) or array count (must be in range O to 10) in ‘receive’ (host-to- 
terminal) block header. 


(Level 3): Parameter 2 memory error. (Out of memory while parsing the <int-array> |) 
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ERROR CODES 


OL BLINELENGTH=< Set-Block-Line-Length> =®c(0)(L)<int> 

OLOO (Level 2): Unrecognized command. (Option 1 not installed.) 

OLO3 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
OL11 (Level 2): Invalid maximum number of characters in line (must be in the range from 5 to 655385). 

OM BMASTERCHARS=< Set-Block-Master-Chars>=&c(O)(M)<int> <int> 

OMOO (Level 2): Unrecognized command. (Option 1 is not installed.) 

OMO3 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
OM11 (Level 2): Invalid “transmit” (terminal-to-host) master char code (0 to 127). 

OM21 (Level 2): Invalid “receive” (host-to-terminal) master char code (0 to 127). 

ON BNONXMTCHARS=< Set-Block-Non-Xmt-Chars > =£c(O)(N)<int-array> <int-array> 

ONOO (Level 2): Unrecognized command. (Option 1 is not installed) 

ONO3 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 


ON11 (Level 2): Invalid character code or array count in list of terminal-to-host non-transmittable characters. (The 
array count must be in the range from O to 20, and the character codes must be in the range from 
0 to 127.) 


ON12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the < int-array> |) 


ON21 (Level 2): Invalid character code or array count in list of host-to-terminal non-transmittable characters. (The 
array count must be in the range from O to 20, and the character code must be in the range from 0 
to 127.) 


ON22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the < int-array> |) 

OP BPACKING=< Set-Block-Packing> = c(O)(P)<Int> <int> <int> <Int> 

OPOO (Level 2): Unrecognized command. (Option 1 is not installed.) 

OPO3 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
OP11 (Level 2): Invalid terminal-to-host unpacked-bits-per-byte (must be 7 or 8). 

OP21 (Level 2): Invalid terminal-to-host packed-bits-per-pseudo-byte (must be 6, 7, or 8). 

OP31 (Level 2): Invalid host-to-terminal unpacked-bits-per-byte (must be 7 or 8). 


OP41 (Levei 2) Invalid host-to-terminal packed-bits-per-pseudo-byte (must be 6, 7, or 8). 
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OS  BLENGTH=< Set-Block-Length> =®c(O)(S)< int+> <int+> 

OSOO (Level 2): Unrecognized command. (Option 1 is not installed.) 

OS03 (Level 2): Command invalid at this time. (Terminal must not be in Block mode or armed for Block mode.) 
OS11 (Level 2): Invalid terminal-to-host block length (must be in the range from 5 to 65535.) 

OS21 (Level 2): Invalid host-to-terminal block length (rnust be in the range from 5 to 65535,) 

OT BTIMEOUT=< Set-Block-Timeout > =£c(O)(T)< int+> 

OTOO (Level 2): Unrecognized command. (Option 1 is not installed.) 

OT11 (Level 2): Invalid timeout (must be in the range from O to 65535 seconds). 

PA PASSIGN=< Port-Assign> = c(P)(A)< string> <string> <Int> 

PAOO (Level 0): Unrecognized command. (Option 10 is not installed.) 

PA11 (Level 2): Invalid port identifier (must be “PO:",“P1:”, or “P2:"), 

PA12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the port name <string> ) 
PA13 (Level 2): Port in use. 


PA21 (Level 2): Invalid protocol identifier (must be "4642," "4643," "4662," “4662/T,” “4663,” “4663/T,” or 
“PPORT”). 


PA22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the <string> ) 

PA31 (Level 2): Invalid device code (must be in the range from —32768 to + 32767). 

PB PBITS=< Set-Port-Stop-Bits> = c(P)(B) <string> <int> <int> 

PBOO (Level 0): Unrecognized command. (Option 10 is not instailed). 

PB11 (Level 2): Port identifier is invalid (must be “PO:", “P1:", or “P2:"). 

PB12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the port name <string> ) 
PB13 (Level 2): Port in use. 

PB21 (Level 2): Invalid number of stop bits (must be 1 or 2). 


PB31 (Level 2): Invalid number of data bits (must be 5, 6, 7, or 8). 
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PC PCOPY=<Port-Copy> = c(P)(C) <string> 

PCOO (Level 0): Unrecognized command. (Option 10 is not installed.) 

PCO2 (Level 3): 3PPI ISR transmit/receive error detected. 

PC11 (Level 2): Invalid “source” port (must be “HO:”, “PO:", “P1:", or “P2:"). 

PC12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the source specifier string.) 
PC13 (Level 2): Port in use. 

PC21 (Level 2): Invalid separator string (must be the empty string or TO"). 

PC22 (Level 3); Parameter 2 memory error. (Out of memory while parsing the separator string.) 

PC23 (Level 2): Destination is busy. 


PC31 (Level 2): Invalid “destination” port (must be “HO:”, “PO:",“P1:" or “P2:", and must be different from the 
“source” port). 


PCG32 (Level 3): Parameter 3 memory error. (Out of memory while parsing the destination specifier.) 
PE PEOF=<Set-Port-EOF-String> =c(P)(E)< string> <int-array> 

PEQO (Level! 0): Unrecognized command. (Option 10 is not installed.) 

PE11 (Level 2): Port identifier is invalid (must be “PO:", “P1:", or “P2:"). 

PE12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the port name < string> .) 
PE13 (Level 2): Port in use. 


PE21 (Level 2): Invalid EOF string. (The <int-array> must have from 0 to 10 elements, and each <int> in the 
array must be in the range from O to 127.) 


PE22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the end-of-file string <int-array>. 
PF PFLAG=< Set-Port-Flagging-Mode> = c(P)(F)<string> <int> <int> <int> 

PFOO (Level 0): Unrecognized command. (Option 10 is not instatied,) 

PF11 (Level 2): Port identifier is invalid (must be “PO:", "P1.", or “P2:"), 

PF12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the port name <string> ) 

PF13 (Level 2): Port in use. 

PF21 (Level 2): Invalid Flagging mode (must be 0, 1 or 2). 

PF31 (Level 2): Invalid “GO” character (must be in range 0 to 127). 


PF41 (Level 2): Invalid “STOP” character (must be in range 0 to 127; if non-zero, must be different from the “GO" 
character). 
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Pi 


PIOO 


PIO2 


PI11 


Pli2 


PI13 


Pl21 


PI31 


P1102 


PL 


PLOO 


PL11 


PL13 


PLi2 


PL20 


PL21 


PL22 


PM 


PMOO 


PM11 


PM12 


ERROR CODES 


PMAP =< Map-Index-To-Pen> =€c(P)(I)< string>> <int> <int> 


(Level 0): 


(Level 3): 


(Level 3): 
(Level 2): 
(Level 2): 
(Level 2): 
(Level 2): 


(Level 3): 


Unrecognized command (Option 10 is not installed). 


No memory is available for the index map. (To guarantee an available index map for a particular 
peripheral port, the peripheral port should have a plotter device assigned to it when the terminal is 
turned on.) 


Port identifier is invalid (must be “PO:", “P1:", or “P2:"). 

Parameter 1 memory error. (Out of memory while parsing the port name string.) 
Port in use. 

Invalid index (must be in the range from —2 to + 32767}. 

Invalid pen number (must be in the range from —i to 255). 


Not enough memory for index map. 


PLOT=< Plot> =c(P)(L)< string> <string> 


(Level 0): 
(Level 2): 
(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


(Level 3): 


Unrecognized command. (Option 10 is not installed.) 

Invalid first parameter (must be the empty string or “TO”). 

Device already in use. 

Parameter 1 memory error. (Out of memory while parsing the <string> parameter.) 


Non-existent destination device. (If destination specifier is of the form “FO:filename” or "'F1: 
filename,” then the corresponding disk drive must be installed, and the file named must exist on a 
disk loaded in that disk drive). 


Invalid output specifier (must be “HO:", “PO:”, “P1:", “P2:", “FO:filename” or “F1 ‘filename’. 


Parameter 2 memory error, (Out of memory while parsing the destination <string> ) 


PEOL=< Set-Port-EOL-String> =£c(P)(M)< string> <int-array> 


(Level 0): 
(Level 2): 


(Level 3): 


Unrecognized command. (Option 10 is not installed) 
Invalid port identifier (must be “PO:”, “P1:", or “P2:"). 


Parameter 1 memory error. (Out of memory while parsing the port name <string> ) 


PM13 (Level 2): Port in use. 


PM21 (Level 2): invalid EOL string (must have 0, 1, or 2 characters). 


PM22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the EOL-string <int-array> ) 
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pp 
PPOO 
PP11 
PP12 
PP13 
PP21 
PQ 
PQO0 
PQo2 
PQti 
PQ12 
PR 
PROO 
PR11 
PR12 
PR13 


PR21 


RA 
RAOO 


RA10 
RA11 
RA21 
RA31 
RB 

RBOO 


RB1 1 
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PPARITY=< Set-Port-Parity > ==c(P)(P)<string> <int> 

(Level 0): Unrecognized command. (Option 10 is not installed). 

{Level 2): Port specifier is invalid (must be “PO:", “P1:", or “P2:”). 

(Level 3): Parameter 1 memory error. (Out of memory while parsing the port name <string> |) 
(Level 2): Port in use. 

{Level 2): Invalid parity code (must be in range 0 to 4). 

PORTSTATUS=< Report-Port-Status > = c(P)(Q)< string> 

(Level 0): Unrecognized command. (Option 10 is not installed.) 

(Level 3): Memory error. (Out of memory while trying to retrieve status information) 

(Level 2): Invalid port identifier (must be “PO:", “P1:", or “P2:”). 

(Level 3): Parameter 1 memory error. (Out of memory while parsing the port specifier string.) 
PBAUD=< Set-Port-Baud-Rate> = c(P)(R) <string> <int> 

(Level 0): Unrecognized command. (Option 10 is not installed.) 

(Level 2): Port identifier is invalid (must be “PO:”, “P1:", or “P2:"), 

(Level 3): Parameter 1 memory error. (Out of memory while parsing the port name string.) 
(Level 2): Port in use. 


(Level 2): Invalid baud rate (must be 50, 75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 
7200, or 9600). 


< Set-View-Attributes> =£Ic(R)(A)<int> <int+> <int+> 

(Level 0): Unrecognized command. (The terminal is not a 4112). 

(Level 2): Surface does not exist (has not been defined with <set-surface-definitions> command). 
(Level 2): Invalid surface number (must be in the range from —1 to + 3). 

(Level 2): Invalid wipe index (must be in the range from 0 to 65535). 

{Level 2): Invalid border index (must be in the range from 0 to 65535). 

< Set-Background-Gray-Level> = c(R)(B)<int> 

(Level 0): Unrecognized command. (The terminal is not a 4112) 


(Level 2): Invalid gray level (must be in the range from 0 to 100). 
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ERROR CODES 


RC <Select-View> =c(R)(C)<int> 

RCOO (Level 0): Unrecognized command. (The terminal is not a 4112) 
RC11 (Level 2): Invalid view number (must be in the range from —1 to 64). 
RD <Set-Surface-Definitions> = c(R)(D)<int-array> 

RDOO (Level 0): Unrecognized command. (The terminal is not a 4112.) 


RD10 (Level 2): Occupied undefined surface. (This command would have resulted in a dialog area viewport, pixel 
viewport, or numbered graphic viewport residing on an undefined surface.) 


RD11 (Level 2): Invalid <int-array> parameter. (The array count must be in the range from 1 to 3. Each <int> in 
the array must be in the range to 3. The sum of the <int>s in the array must be in the range from 
1 to 3) 


RD12 (Level 3): Parameter 3 memory error. (Out of memory while trying to parse the <int-array> parameter.) 
RE  <Set-Border-Visibility> =®c(R)(E)<int> 

REOO (Level 0): Unrecognized command. (The terminal is not a 4112.) 

RE11 (Level 2}: Invalid “border mode” parameter (must be 0, 1, or 2). 

RF FIXUP=< Set-Fixup-Level> = ®c(R)(F)<int> 

RFOO (Level 0): Unrecognized command. (The terminal is not a 4112) 

RF11 (Level 2): Invalid fixup level (must be in the range O to 6). 

RG =< Set-Surface-Gray-Levels> ='c(R)(G)< int> <int+ array> 

RGOO (Level Q): Unrecognized command. (The termina! is not a 4112.) 

RG10 (Level 2): Surface does not exist (nas not been defined with a <set-surface-definitions> command). 
RG11 (Level 2): Invalid surface number (must be in the range 1 to 3). 


RG21 (Level 2): Invalid surface-gray-levels array. (The array count must be even; the first <int+ > in each pair 
must be a gray-index in the range from 1 to 65535; the second <int> in each pair must be a valid 
gray-level: a number in the range from 0 to 100.) 


RG22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the <int-array> parameter) 
RH < Set-Pixel-Beam-Position> =®c(R)(H)< xy> 


RHOO (Level 0): Unrecognized command. (The terminal is not a 4112) 
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RI < Set-Surface-Visibility> = c(R) (I) <int-array> 
RIOO (Level 0): Unrecognized command. (The terminal is not a 4112.) 


RI10. (Level 2): A surface number in the <int-array> is for a surface which does not exist (that is, a surface which 
has not been defined with a < set-surface-definitions> command). 


Rli1 (Level 2): Invalid <int-array>. (The <int-array> consists of (surface number, visibility) pairs; the ‘surface 
number” <int>s must be 1, 2, or 3; and the ‘visibility’ <int>s must be 0, 1, or 2.) 


RI12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the <int-array> parameter.) 

RJ =< Lock-Viewing-Keys> =®c(R) (J) <int> 

RJOO (Level 0}: Unrecognized command. (The terminal is not a 4112) 

RJ1t1 (Level 2): Invalid locking mode parameter (must be O or 1). 

RK <Delete-View> = c(R)(K)<int> 

RKOO (Level 0): Unrecognized command. (The terminal is not a 4112) 

RK10 (Level 2): The designated view does not exist (has not been defined with a <select-view> command). 
RK11 (Level 2): Invalid view number (must be in the range from —1 to 64). 

RL =< Runlength-Write> =€c(R)(L)< int array> 

RLOO (Level 2): Unrecognized command. (The terminal is not a 4112) 


RL11 (Level 2): Invalid runlength-code array. (The array count must be in the range from 0 to 65535, and each 
<int+ > in the array must also be in the range from 0 to 65535.) 


RL12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the runlength-code array, or while 
attempting to execute the command.) 


RN = <Set-Surface-Priorities> =£c(R)(N)<int-array> 
RNOO (Level 0): Unrecognized command. (The terminal is not a 4112) 
RN10 (Level 2): Surface does not exist (has not been defined with a < set-surface-definitions> command). 


RN11 (Levelt 2): Invalid surface priorities array. (Each <int> in the <int-array> — whether a surface number ora 
priority number — must be in the range from 1 to 3)) 


RN12 (Level 3): Parameter 1 memory error. (Out of memory while parsing the <int-array> parameter.) 
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RP 


RPOO 


RP11 


RP21 


RP22 


RR 


RROO 


RR11 


RR21 


RR31 


RS 


RSOO 


R811 


R821 


RU 


RUOO 


RU10 


RU11 


RU21 


RU31 


RV 


RVOO 


RV11 


RV21 
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ERROR CODES 


< Raster-Write> =*c(R)W)< int> <char-array> 


(Level 0): 
(Level 2): 
(Level 2): 


(Level 3): 


Unrecognized command. (The terminal is not a 4112) 
Invalid number of pixels (must be in the range from O to 65535). 
There are too many or too few pixels in the <code-array>. 


Parameter 2 memory error. (Out of memory while parsing the < char-array> parameter.) 


<Rectangle-Fill> = c(R)(R}<xy> <xy> <int+> 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is not a 4112) 


Invalid “lower left” coordinates. (X must be in the range from O to 639, and Y in the range from 0 to 
479,) 


Invalid “upper right” coordinates. (X must be in the range from O to 639, and Y in the range from 0 
to 479.) 


Invalid gray-index (must be in the range from 0 to 65535.) 


< Set-Pixel-Viewport > =—c(R)(S)<xy> <xy> 


(Level 0): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is not a 4112) 


Invalid ‘lower left” coordinate. (X must be in the range from 0 to 639, and Y in the range from 0 to 
479.) 


Invalid “upper right” coordinate. (X must be in the range from O to 639, and Y in the range from 0 
to 479) 


< Begin-Pixel-Operations > ="c(R)(U)< int> <int> <int> 


(Level 0): 
(Level 2): 
(Level 2): 
(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is not a 4112) 

Surface does not exist (has not been defined with a < set-surface-definitions> command). 
Invalid surface number (must be in the range from —1 to 3). 

Invalid ALU mode (must be in the range from 0 to 16). 


Invalid bits-per-pixel (must be O, 1, 2, 3, or 6). 


< Set-Viewport > = c(R)(V) < xy> <xy> 


(Level 0}: 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is not a 4112) 


Invalid “lower left” corner. (X must be in the range from O to 4095, and Y in the range from 0 to 
3071.) 


invalid “upper right” corner. (X must be in the range from O to 4095, and Y in the range from 0 to 
3071)) 
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RW <Set-Window> = c(R)(W)< xy> <xy> 

RWOO (Level 0): Unrecognized command. (The terminal is not a 4112) 
RX = <Pixel-Copy> =®c(R)(X)<int> <xy> <xy> <xy> 

RXOO (Level 0): Unrecognized command. (The terminal is not a 4112) 
RX10 (Level 2): The specified surface does not exist. 


RX21 (Level 2): Invalid destination-lqwer-left-corner. (X must be in the range from O to 639, and Y must be in the 
range from 0 to 479.) 


RX31 (Level 2): Invalid first-source-corner. (Same range as for the destination-lower-left-corner,) 


RX41 (Level 2): Invalid second-source-corner. (Same range as for the destination-lower-left-corner and the first- 
source-corner,) 


SA  <Set-Segment-Class> =c(S)(A)< int> <int-array> <int-array> 

SAO3 (Level 2): Command invalid at this time: the specified segment is currently being defined. 
SA10 (Level 2): Segment does not exist. 

SA11 (Level 2): Invalid segment number (must be in the range from —3 to —1, or from 1 to 32767). 


SA21 (Level 2): Invalid “removal” class number array. (Each class number must be —1 or in the range from 1 to 
64) 


SA22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the “removal” < int-array> parameter.) 
SA31 (Level 2): Invalid “include” class number array. (Same rules as for the “removal” class number array.) 
SA32 (Level 3): Parameter 3 memory error. (Out of memory while parsing the “addition” <int-array> parameter.) 
SC <End-Segment> =®c(S)(C) 

SCO3 (Level 2): Invalid at this time: no segment is currently being defined. 

SCO02 (Level 3): Out of memory while performing <end-segment> command. 

SD <Set-Segment-Detectability> =&c(S)(D)<int> <int> 

SD03 (Level 2): Command is invalid at this time. (The specified segment is currently being defined.) 

SD10 (Level 2): Segment does not exist. 

SD11 (Level 2): Invalid segment number (must be in the range —3 to —1, or 1 to 32767). 


$D21 (Level 2): Invalid “detectability mode” (must be O or 1). 
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SG 


SGO02 


SG10 


SG11 


8G21 


$G31 


SH 


SHO3 


SH10 


SH11 


SH21 


SI 


$103 


$102 


$110 


Sli 


$l21 


$131 


$141 


SK 


SK10 


SK11 


SL 


SL11 


SL12 


SL21 


SL22 
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ERROR CODES 


< Set-Graphtext-Font-Grid> = c(S)(G)<int> <int> <int> 


(Level 3): 
(Level 2): 
(Level 2): 
(Level 2): 


(Level 2): 


Out of memory while defining font grid. 

Font already exists. 

Invalid font number (must be in the range from O to 32767). 
invalid grid width (must be in the range from 1 to 4095). 


Invalid grid height (must be in the range from 1 to 4095). 


< Set-Segment-Highlighting > = c(S)(H)<int> <int> 


(Level 2): 
(Level 2): 
(Level 2): 


(Level 2): 


Command is invalid at this time. (The specified segment is currently being defined.) 
Segment does not exist. 
Invalid segment number (must be in the range from —3 to —1 ,or from 1 to 32767). 


Invalid Highlighting mode (must be 0 or 1). 


< Set-Segment-Image-Transform> =®c(S) (I) < int> <real> <real> <real> <xy> 


(Level 2): 
(Level 3): 
(Level 2): 
(Level 2): 
(Level 2): 
(Level 2): 


(Level 2): 


Command is invalid at this time. (The specified segment is currently being defined.) 
Out of memory while transforming segment. 

Segment does not exist. 

Invalid segment number (must be in the range —3 to —1, or 1 to 32767). 

Invalid X-scaling factor. (Must be in the range from —32767.0 to + 32767.0,) 
Invalid Y-scaling factor. (Must be in the range from —32767.0 to + 32767.0.} 


Invalid rotation angle. (Must be in the range from —32767.0 to + 32767.0) 


< Delete-Segment > ="c(S)(K)<int> 


(Level 1): 


(Level 2): 


Segment does not exist. 


Invalid segment number (must be —3, —1, or in the range from 1 to 32767). 


< Set-Current-Matching-Class> =c(S)(L) < int-array> <int-array> 


(Level 2): 
(Level 3): 
(Level 2): 


(Level 3): 


Invalid “include” segment-ciass array. (Class numbers must be in the range from 1 to 64.) 
Parameter 1 memory error. (Out of memory while parsing the “include” segment-class array.) 
Invalid “exclude” segment-class array. (Class numbers must be in the range from 1 to 64) 


Parameter 2 memory error. (Out of memory while parsing the “exclude” segment-class array.) 
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SM  <Set-Segment-Writing-Mode> =*c(S)(M)<int> <int> 

SMO3 (Level 2): Command is invalid at this time. (The specified segment is currently being defined.) 
SM10 (Level 2): Segment does not exist. 

SM11 (Level 2): Invalid segment number (must be in the range from —3 to —1, or from 1 to 32767). 
SM21 (Level 2): Invalid Writing mode (must be O or 1). 

SO <Begin-Segment> =*c(S)(O)<int> 

SOO02 (Level 3): Out of memory while defining segment. 


$003 (Level 2): Command is invalid at this time. (Another segment, a graphtext character, or a panel is currently 
being defined.) 


SO10 (Level 2): Segment already exists. 
S$O11 (Level 2): Invalid segment number (must be in the range from 1 to 32767). 


SP = < Set-Pivot-Point > =®c(S)(P)<xy> 


No errors are detected for this command. 

SQ = <Report-Segment-Status> ==c(S)(Q)< int> <char-array> 

SQ10 (Level 2): Segment does not exist. 

SQ11 (Level 2): Invalid segment number (must be in the range —3 to + 32767). 


SQ21 (Level 2): Invalid array of codes. (Must include only the uppercase letters A, D, H, |, M, P, S, V, and X, Also, 
the array count must be in the range from 0 to 32767)) 


$Q22 (Level 3): Parameter 2 memory error. (Out of memory while parsing the aray-of-codes < char-array> ) 
SR  <Rename-Segment> ='c(S)(R)<int> <int> 

SRO3 (Level 2): Command is invalid at this time. (The specified segment is currently being defined.) 

SR10 (Level 2): Segment does not exist. 

SR11 (Level 2): Invalid segment number (must be in the range from 1 to 32767). 

SR20 (Level 2): Asegment with that segment number already exists. 


SR21 (Level 2): Invalid segment number (must be in the range from 1 to 32767). 
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SS  <Set-Segment-Display-Priority > ="c(S)(S)<int> <int> 

$803 (Level 2): Command is invalid at this time. (The specified segment is currently being defined) 
$S10 (Level 2): Segment does not exist. 

$811 (Level 2): Invalid segment number (must be in the range from —3 to —1, or from 1 to 32767). 
$821 (Level 2): Invalid priority number (must be in range —32768 to + 32767). 

ST  <Begin-Graphtext-Character> = c(S)(T)<int> <int> 

STO2 (Level 3): Out of memory while defining graphtext character. 


STO3 (Level 2): Command is invalid at this time. (A segment, panel, or graphtext character is currently being 
defined.) 


ST11 (Level 2): Invalid font number (must be in the range from O to 32767). 

ST20 (Level 2): That character already exists in this font. 

ST21 (Level 2): Invalid character number (must be in the range from 32 to 126). 

SU  <End-Graphtext-Character> = c(S)(U) 

SUO3 (Level 1): This command is invalid at this time. (No graphtext character is being defined.) 
SV < Set-Segment- Visibility > ="c(S)(V)<int> <int> 

SVO3 (Level 2): Command is invalid at this time. (The specified segment is currently being defined) 
SV10 (Level 2): Segment does not exist. 

SV11 (Level 2): Invalid segment number (must be in the range from —3 to + 32767). 

SV21 (Level 2): Invalid visibility mode (must be 0 or 1). 

SX  <Set-Segment-Position> =*c(S)(X)<int> <xy> 

SX03 (Level 2): Command is invalid at this time: the specified segment is currently being defined. 
SX10 (Level 2): Segment does not exist. 

SX11 (Level 2): Invalid segment number (must be in the range from —3 to + 32767) 

$Z  <Delete-Graphtext-Character> =c(S)(Z)<int> <int> 

$Z03 (Level 2): Command is invalid at this time. (A graphtext character is currently being defined.) 
$Z10 (Level 1): The specified font does not exist (no characters have been defined for that font). 
$Z11 (Level 2): Invalid font number (must be in the range from —1 to 32767). 

$Z20 (Level 1): The character specified does not exist in this font. 


3221 (Level 2): Invalid character number (must be — 1, or in the range from 32 to 126). 
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Appendix B 


POWER UP SEQUENCE AND SELF TEST 


This appendix explains the messages which can 
appear on the screen during the power up sequence if 


a problem is detected. it also explains how to use the 
terminal’s extensive self test procedure. 


THE POWER UP SEQUENCE 


Each time you turn the terminal on, it automatically 
tests parts of its memory and circuitry. This is called 
the “power up sequence.” It takes from 15-60 seconds 
depending on what options your terminal has, and 
requires no operator interaction. 


During the power up sequence the lights in the 
keyboard go through the following sequence: 


All lights turn on. 

@ The CAPS LOCK light turns off. 

@ All other lights turn off. 

@ The XMT and RCV lights flash once simultaneously. 
® Ail lights turn off. 


If the terminal bell does not ring during the power up 
sequence (within 60 seconds of turning the terminal 
on), the cursor flashes in the upper left corner of the 
screen. If the dialog area is enabled, the light in the 
DIALOG key is on and the cursor appears on the first 
available line of the dialog area. As soon as the cursor 
appears on the screen, the terminal is ready for use. 


lf the power up sequence detects an error the terminal 
bell rings one, three, or four times, depending on the 
severity of the problem. There may also be a message 
on the screen. 


POWER UP ERROR 


If the power up Sequence encounters an error which 


will not prevent you from using the terminal (a non-fatal 


error), the bell rings one time and a message is 
displayed on the screen. 
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If the terminal bell rings and you cannot read the 
message that is displayed, press the RESET button 
(Figure B-1). This causes the screen to be erased and 
the power up sequence to be run again so you can read 
the message. 


MASTER RESET 


SELF TEST 


BRIS 


Figure B-1. The MASTER RESET and SELF TEST Buttons. 
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An example of a such an error is when a problem exists 
which prevents you from using one of the terminal's 
options. If this happens, the bell rings once anda 
message is displayed. For example, if the disk option 
failed the power up sequence, the following message 
would appear: 


FOM Set: 42-Fail 


| there is a problem with a tablet option, the following 
message appears: 


ROM Set: 13-Fail 


When an option fails, that option cannot be accessed 
but the rest of the terminal's features can still be used. 
You can report the failure to a service person, or run 
the self test procedure (described later in this appen- 
dix) to isolate the failure more specifically. 


\f an error occurs when the terminal is checking its 
keyboard, the following message can appear: 


Keyboard I-D — XX 


where XX is a keyboard ID value. If this occurs, record 
the message and contact a service person. 


The terminal has a ‘setup memory,” which remembers 
many of the terminal's parameters or settings after itis 
turned off. These attributes are reinstated the next time 
the terminal is turned on. If that memory fails, the 
terminal bell rings once and the following message 
appears on the screen: 


Setup Defaults Reset 


This occurs if the terminal's configuration has been 
altered by putting in or taking out a circuit board. It also 
occurs if the battery which powers the setup memory 
fails. It is important to note that if you change one or 
more boards, only the parameters affected by the 
change are reset. If the setup memory battery fails, all 
parameters are reset to default. 
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FATAL ERRORS 


The terminal is not operational (fatal error) if its 
standard system fails. If that happens, the terminal bell 
rings four times, once when the following message 
appears on the screen and three times when the fatal 
error is reported: 


ROM Set: 00-Fail 


If the power up sequence encounters a fatal error 
before the screen is checked, the terminal bell rings 
three times and the indicator and keyboard lights blink 
in a particular sequence. The sequence in which they 
flash indicates the test which has failed. 


If this occurs, you should record the light pattern and 
report it to a qualified service technician. You may also 
want to run the self test procedure, explained iater in 
this section, which provides more detailed information 
that you can relay to a qualified service technician. 


When there is a fatal error, the terminal cannot be 
operated except to run the self test procedure. 
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POWER UP SEQUENCE AND SELF TEST 


SELF TEST 


GENERAL SELF TEST 


The power up sequence is an abbreviated test of the 
terminal's memory and circuitry. 


A more extensive test of the terminal's operating 
conditions is initiated by the SELF TEST button. The 
SELF TEST thoroughly tests the terminal and allows a 
service technician to make any necessary adjustments. 


If the terminal detects an error in the power up 
sequence, you can run the self test procedure to 
isolate the problem. You can then report the specific 
problem to a technician. 


The self test is initiated by pressing the SELF TEST 
and RESET buttons (Figure B-1) in the following 
sequence: 


@ Press SELF TEST. 


@ Continue to hold SELF TEST while you press and 
release RESET. 


@ Continue to hold SELF TEST until the indicator lights 
begin to ripple. 


e@ Release SELF TEST. 


For about the first three minutes of the self test, the 
light patterns continue to change as tests are run. If a 
module fails, the terminal bell rings twice and a light 
pattern remains on for 20 seconds, indicating the test 
that has failed. You can record that pattern to report it 
to a technician. 


Sub Messages 


In addition to this initial light-coded message, many 
messages have up to three “sub messages” which can 
provide a technician with even more information about 
the problem. 
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lf you want to view the sub messages, start the 
following sequence within 20 seconds after the initial 
message appears. (If you take no action, the self test 
continues in 20 seconds.) 


1. Press the RETURN key. 


2. The terminal bell rings twice and another light 
pattern is displayed. 


Record the light pattern and press RETURN again. 


If there is another sub message, the bel! rings 
twice and another light pattern is displayed. 


Record the light pattern and press RETURN. 


lf there is a third sub message the bell rings twice 
and another light pattern is displayed. 


Record the light pattern and press RETURN. 


8. When you have seen all of the sub messages, there 
is no bell when you press RETURN, the light in the 
CAPS LOCK key turns off, and the indicator light 
pattern changes to indicate that the next test in the 
self test procedure is being run. 


Error messages are displayed in this manner as the 
terminal checks its display. After the display has been 
checked, subsequent error messages are displayed on 
the screen instead by light patterns. If the test halts 
during this part of the test, it is because the screen is 
filled with error messages. Make a hard copy or write 
down the error messages. Press the PAGE key and the 
test wil! continue. 


The self test procedure is explained in more detail in 
the 4112 Service Manual. 
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RESETTING SETUP MEMORY 


You may find it necessary or desirable to restore the 
terminal’s environment to the factory defaults. This is 
accomplished within the self test procedure. To do so, 
take the following steps: 


1. 
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Initiate the self test as explained 6arlier in this 
appendix. 


Within 20 seconds of initiating the self test, press 
and hold the CTRL key while you press and 
release the C key, then release the CTRL key. This 
causes the light in the CAPS LOCK key to stop 
flashing and the following menu is displayed on the 
screen: 


411% Menu 

f1 4112 Display 

fe Processor Board 
f3 Disk 

f4 Tablet 
Selection 

¥ 


Press function key 2 (F2). The following menu 
appears on the screen: 


Processor Board Menu 
f1 CMOS-Reset 

fe Keyboard 

f3 Host Port 
Selectian 

¢ 


4. 


Press function key 1 (F1). The following message 
appears below the menu: 


Processor Board Menu 
f1 CMOS-Reset 

f2 Keyboard 

f3 Host Port 
Selection 

*f1 

CMOS -Reset 

Selection 

¥ 


The term “CMOS RESET” means that the Setup 
memory has been restored to its factory default 
values. 


Press and hold the CTRL key while you press and 
release the E key, and then release the CTRL key. 
The terminal exits from the self test procedure, 
runs the power up sequence and when the cursor 
appears, it is ready for use. 
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Appendix C 


ESCAPE SEQUENCE COMMANDS 


Commands which are most commonly used by a 4112 
operator have an English-like format and are called 
setup commands, as explained in Section 6. 


However the terminal can also execute many more 
commands, which are issued in a format called “es- 
cape sequences.” They are called escape sequences 
because the first character in the command is always 
an escape. All terminal commands (including setup 
commands and command keys) have an escape se- 
quence format. 


Although escape sequences are primarily used by the 
host to send commands to the terminal, you can enter 
an escape sequence from the terminal as well, in either 
Setup or Local modes. The escape sequences are 
entered in a slightly different format for each of the two 
modes. 


This appendix briefly discusses escape sequence 
commands and lists the format for each. See the 4112 
Host Programmer's Manual and the 4110 Series Com- 
mand Reference Manual for details on the use of 
escape sequences. 


TWO FORMATS 


There are two different formats for escape sequence 
commands. 


One format consists of the escape character followed 
by a single character op code. Escape sequences in 
this format can only be entered in Local mode ona 
4112. |In a general form, this could be represented as 
follows (Fc represents the escape character, X 
represents a single ASCil character): 


EcX 
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The second (4110-family) format consists of the 
escape character followed by a two-character op code 
and sometimes one or more parameters. Escape se- 
quences in this format can be entered in either Local or 
Setup modes, though they are entered slightly differ- 
ently in each mode. This format could be represented 
as follows. (The &c represents the escape character. 
Each “(X)” represents a single ASCII character; the 
parentheses are included to distinguish between the 
characters. Each <parameter> may be an ASCIl 
character, a string of ASCII characters, or a real 
number.) 


Ec(X)(X)< parameter> <parameter> ... 
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ESCAPE SEQUENCES IN SETUP MODE 


Ali escape sequence commands which consist of the 
escape character followed by a two-character op code 
can be executed in Setup mode. The following list 
details the format of escape sequences in Setup mode: 


@ The first character in the command is the “escape.” 
@ All alphabetic characters must be upper case. 


@ There is no space between the “escape” character 
and the two-character op code of the command. 


@ If the command has parameters, enter one or more 
spaces after the op code and then enter the 
parameters with one or more spaces between each 
parameter. 


@ Enter keyword parameters in their English-like for- 
mat; enter numeric values in a normal way (special 
encoding is not necessary as it is in Local mode). 


@ Terminate the command with a carriage return, 
which causes the command to be executed. 


For example, if the dialog area is enabled but not 
visible, you press the DIALOG key to make the dialog 
area visible. There is also an escape sequence 
command which makes the dialog area visible. 


You can execute that command in Setup mode as 
follows: 


1. Put the terminal into Setup mode. If the light in the 
SET UP key is on, the terminal is already in Setup 
mode. If it is not on, press the SET UP key and the 
light turns on as the terminal enters Setup mode. 


ine) 


The terminal should not be in Local mode. The light 
in the LOCAL key should be off; if it is on, press the 
key and the light will go off as the terminal exits 
from Loca! mode. 


The light in the CAPS LOCK key should be on, 
indicating that the key is active and all alphabetic 
characters will be upper case. 


ae) 


4. Enter the following command: 
EcLV YES Cn 
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That is, press the “ESC,” "L,” and “V” keys with no 
spaces between them. Then enter a “space” and the 
keyword “YES" followed by the carriage return. The 
characters are echoed on the screen as you enter them 
and the command is executed when you enter the 
carriage return. If the dialog area was not visible before 
you entered the command, it becomes visible. If the 
dialog area was already visible, nothing happens. 


The following command initializes the terminal for 
graphics input (GIN) mode, setting it to use the 
thumbwheels as the input device for ten points: 


EslE O 10 Cr 


Press the SET UP key to exit from Setup mode. You 
can use the thumbwheels to locate the crosshair 
cursor and press ten alphabetic keys to exit from GIN 
mode. Or, you can put the terminal back into Setup 
mode and enter the following escape sequence com- 
mand: 


EcID O Sr 
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ESCAPE SEQUENCE COMMANDS 


ESCAPE SEQUENCES IN LOCAL MODE 


When the terminal is in Local mode, you can execute 
both 4010 and 4110-family escape codes. In both 
cases, escape sequences have the following charac- 
teristics. Notice that the first two characteristics are 
the same as using Setup mode, but the rest are 
different: 


® The first character in the command is the “escape.” 
® All alphabetic characters must be upper case. 


@ No carriage return is necessary; the command is 
executed as soon as you enter the last character. 


® Characters are not echoed on the screen as you 
type them. 


® Parameters of a command are not delimited by a 
space (although a space is a valid character in some 
commands). 


@ Keywords and numeric values greater than nine are 
entered in an encoded form (see the 4110 Series 
Command Reference Manual). 


The escape sequence to make the dialog area visible 
can be entered in Local mode as follows: 


1. Put the terminal into Local mode. If the light in the 
LOCAL key is on, the terminal is in Local mode. If it 
is not on, press the LOCAL key and the light turns 
on as the terminal enters Local mode. 


2. The terminal should not be in Setup mode. The 
light in the SET UP key should be off; if it is on, 
press the key and the light will go off as the 
terminal exits from Setup mode. , 


3. The light in the CAPS LOCK key should be on, 
indicating that the key is active and all alphanelc 
characters will be upper case. 


4. Press the following keys; the characters will not be 
echoed on the screen. 


EcLV1 
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The command is executed when you enter the last 
character. i in the command. If the dialog area was not 
visible before you entered the command, it becomes 
visible. If the dialog area was already visible, nothing 
happens. 


The following command initializes the terminal for 
graphics input (GIN) mode, setting it to use the 
thumbwheels as the input device for ten points (the 


. colon at the end of the command is the coded form of 


the integer 10 in Local mode escape sequence com- 
mands): 


EcIEO: 
Press the LOCAL key to exit from Local mode. You can 


use the thumbwheels to locate the crosshair cursor 
and press ten alphabetic keys to exit from GIN mode. 


~ Or, you can put the terminal back into Local mode and 


enter the following escape sequence command: 


. EcIDO 


C3 


ESCAPE SEQUENCE COMMANDS 


LIST OF ESCAPE SEQUENCES 


The rest of this appendix lists the terminal's 4110-style Parameters for escape sequence commands are 
escape sequences. They are listed alphabetically explained in the 4110 Series Command Reference 
according to their two-character op code. The setup Manuai and the 4112 Programmer's Manual. 
command is shown if the escape sequence has one. 


Escape Sequence 


Ec(I)(!) < ASCII-CHAR> 


Ec(I)(A)< int> 


Disable-4953-Tablet-GIN 


Set-Pick-Aperture 


Setup Command 


None 


PICKAPERTURE 


Eo(I)(C)<int> <int> Set-GIN-Cursor None 
Ec(I)(E)<int> <int+ > Enable-GIN None 
Ec(I)(F)<int> <int> <int> Set-GIN-Stroke-Filtering TBFILTER 
Ec(IN(G)<int> <int> <int> Set-GIN-Gridding GRIDDING 
Ec(I)(H) <int> Set-Tablet-Header-Characters TBHEADERCHARS 
Eo(I)(I)<int> <int> Set-GIN-Inking None 

Ec (I)(L)< int> Set-Report-Max-Line-Length None 

Eo(1)(M)< int> Set-Report-EOM-Frequency REOM 

Eo(I)(N)< int-array> Set-Tablet-Area TBSIZE 

Ec(I)(P)< int> Report-GIN-Point None 

Ec(1)(Q)< char> < char> Report-Terminal-Settings None 
Ec(I)(R)<int> <int> Set-GIN-Rubberbanding None 

Ec(I)(S)< int> <char> <char> Set-Report-Sig-Chars None 

Ec (I(T) < int> Set-Tablet-Status-Strap TBSTATUS 
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Escape Sequence 
Ec(J)(C)< string> 
<string> <string> 


Ec(J)(D)< string> 
<string> <string> 


Eo(J)(E) 
Eo(J)(F)< string> <int> 


Ec(J)(K) <string> 


Ec(J)(L)< string> 
Ec(JU)(P) <string> <int> 
Ec(J)(Q)< string> 


Eo(J)(R)< string> 
<string> <string> 


Ec(U)(S)< string> 
<string> <string> 


Eo(J)(V) <string> 


<int> <string> <string> 


Ec (K)(A)<int> 
Fe (K)(C) 


Ec(K)(D)< int> <int-array> 


Ec(K)(E)<int> 


Eo(K)(F)< int> 
Ee (K)(H) < int> 
Ec(K)(I)< int> 

Fc(K)(L)< int> 


Ec(K)(M)< int> 
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Command 


Copy 


Directory 


Stop-Spooling 


Format-Volume 


Delete-File 


Load 
Protect-File 
Report-Device-Status 


Rename-File 


Spool 


Save 


Enable-Dialog-Area 
Cancel 
Define-Macro 


Echo 


LFCR 
Hardcopy 
Ignore-Deletes 
Lock-Keyboard 


Set-Margins 
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Setup Command 


COPY 


DIRECTORY 


STOP 
FORMAT 


DELETE 


LOAD 
PROTECT 
None 


RENAME 


SPOOL 


SAVE 


DAENABLE 
None 
DEFINE 


ECHO 


LFCR 

None 
IGNOREDEL 
LOCKKEYBOARD 
MARGINS 
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Escape Sequence 


Ec(K)(N)<int> 
Ec(K)(P)<int> 
Eo(K)(Q) 

Ec(K)(R)<int> 


Ec(K)(S)< int> 


Ec(K)(T)<int> 
Ec(K)(X)<int> 
Ec(K)(Y)< int> 
Ec(K)(Z)<int> <int> <int> 


Ec(L)(B)<int+ > 


Ec(L)(C)<int> 
Ec(L)(E) 

Eo(L)(F)< xy> 
Eo(L)(G)<xy> 


Ec(L)(H)< xy> 


Ec(L)(I)< int+ ><int+ > <int+ > 
Ec(L)(K)<int> 
Fe(L}(L)<int> 
Ec(L)(M)< int> 


Ec(L)(P)< xy> <int> 


Fc(L)(S)< int> 
Ec(L)(T)<string> 
Ee(L)(V)<int> 
Ec(L)(X)< xy> 


Ee(L)(Z) 
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Command 


SSS E———————SS 


Renew-View 
Set-Page-Full-Action 
Report-Errors 

CRLF 


Snoopy 


Set-Error-Threshold 
Expand-Macro 
Set-Execute-Toggle-Char 
Set-Edit-Chars 


Set-Dialog-Area-Buffer-Size 


Set-Dialog-Area-Chars 
End-Panel 

Move 

Draw 


Draw-Marker 


Set-Dialog-Area-Index 
Include-Copy-of-Segment 
Set-Dialog-Area-Lines 
Set-Dialog-Area-Writing-Mode 


Begin-Panel-Boundary 


Set-Dialog-Area-Surface 
Graphic-Text 
Set-Dialog-Area-Visibility 
Set-Dialog-Area-Position 


Clear-Dialog-Scroll 


Setup Command 


RENEW 
PAGEFULL 
None 
CRLF 


SNOOPY 


ERRORLEVEL 
None 
KEYEXCHAR 
EDITCHARS 


DABUFFER 


DACHARS 
None 
None 
None 


None 


DAINDEX 
None 

DALINES 
DAMODE 


None 


DASURFACE 
None 

DAVIS 
DAPOSITION 


None 
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Escape Sequence 


Ec(M)(C)<int> <int> <int> 


Ec(M)(D)<int> <int> <int> <int> 


Eo(M)(E) 
Eo(M)(F)< int> 


Ec(M)(G)<int> 


Ec(M) (I) <int> 
Ec(M)(L)< int+ > 
Ec(M)(M)< int> 
Eo(M)(P)< int> 


Ec(M)(Q)< int> 


Ec(M)(R)< real> 

Ec(M)(S)< int> <int> <int> 
Ec(M)(T)<int+ > 
Ec(M)(V)<int> 


Ec(M)(W)< int> 


Ec(M)(Z)<int> <int> <int> 
Ec(N)(B)< int> 

Ec(N)(C)< int> <int> 
Eo(N)(D)<int> 


Ec(N)(E)<int-array> 


Eo(N)(F)<int> 
Ec(N)(K)<int+ > 
Ec(N)(L) <int+ > 
Ec(N)(M)< int> 


Eo (N)(P)< int> 
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--: Command 


-Set-Graphtext-Size 


“End-Fill-Pattern 


*Select-Fill-Pattern 


Set-Graphtext-Precision 


Setup Command 


Begin-Fill-Pattern 


Set-Graphtext-Font 


Set-Graphics-Area-Writing- 
Mode 


Set-Pick-ID 
Set-Line-Index 


Set-Marker-Type 


Set-Graphtext-Rotation 
Set-Panel-Filling- Mode 
Set-Text-Index 


Set-Line-Style 


Set-Line-Width 


Set-Alphatext-Size 
Set-Stop-Bits 
Set-EOM-Chars 
Set-Transmit-Delay 


Set-EOF-String 


Set-Flagging-Mode 
Set-Break-Time 
Set-Transmit-Rate-Limit 
Prompt-Mode 


Set-Parity 


None- 
None 
None 
None © 


GAMODE 


None 
None 
None 
None 


None 


None 
None 
None 
None 


None 


ALPHASIZE 


' STOPBITS 


EOMCHARS 
XMTDELAY 


EOFSTRING 


FLAGGING 
BREAKTIME 
XMTLIMIT | 
PROMPTMODE 


PARITY 
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Escape Sequence 


Eo(N)(Q)<int+ > 
Eco(N)(R)<int+ > <int+ > 
Ec(N)(S)< int-array> 
Ec(N)(T)< int-array> 


Eo(N)(U)<int> 


Ec(O)(B)<int> 
Es(O)(C)<int> <int> 
Fc(O)(D)<int> 
Ec(O)(E)<int> <int> 


Eo(O)(H)< int-array> <int-array> 


Ec(O)(L)< int> 

Ec(O)(M)<int> <int> 

Fc(O)(N)< int-array> <int-array> 
Ec(O)(P)< int> <int> <int> <int> 


Ec(O)(S)< int+ > <int+ > 


Ee(O)(T)<int+ > 

Ec(P)(A) <string> <string> < int> 
Ec(P)(B)< string> <int> <int> 
Ec(P)(C) <string> 


Es(P)(E)< string> < int-array> 


Ec(P)(F)< string> 
<int> <int> <int> 


Fe(P)(1)< string> <int> <int> 
Ec(P)(L)< string> <string> 
Ec(P)(M) <string> <int-array> 


Ec(P)(P) <string> <int> 
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Set-Queue-Size 
Set-Baud-Rates 
Set-Prompt-String 
Set-EOL-String 


Set-Bypass-Cancel-Char 


Arm-For-Block-Mode 
Set-Block-Continue-Chars 
Set-Duplex-Mode 
Set-Block-End-Chars 


Set-Block-Headers 


Set-Block-Line-Length 
Set-Block-Master-Chars 
Set-Block-Non-Xmt-Chars 
Set-Block-Packing 


Set-Block-Length 


Set-Block-Timeout 
Port-Assign 
Set-Port-Stop-Bits 
Port-Copy 
Set-Port-EOF-String 


Set-Port-Flagging-Mode 


Map-Index-To-Pen 
Plot 


Set-Port-EOL-String 


Set-Port-Parity 
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Setup Command 


QUEUESIZE 
BAUDRATE 
PROMPTSTRING 
EOLSTRING 
BYPASSCANCEL 


BLOCKMODE 
BCONTINUECHARS 
DUPLEX 
BENDCHARS 


BHEADERS 


BLINELENGTH 
BMASTERCHARS 
BNONXMTCHARS 
BPACKING 
BLENGTH 


BTIMEOUT 
PASSIGN 
PBITS 
PCOPY 
PEOF 


PFLAG 


MAPINDEX 
PLOT 
PEOL 
PPARITY 
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Escape Sequence 


Ec(P)(Q)< string> 

Ec(P)(R) <string> <int> 
Ec(R)(A)<int> <int+ > <int+ > 
Ec(R)(B)< int> 


Ec(R)(C)< int> 


E¢(R)(D) < int-array> 

Eo (R)(E)<int> 

Ec(R)(F)<int> 
Ec(R)(G)<int> <int+ array> 


Ec(R)(H)<xy> 


Ec(R)(I)<int-array> 
Fo (R)(J)<int> 
Fc(R)(K)< int> 
Ec(R)(L)<int+ array> 


Ec(R)(N)< int-array> 


Ec(R)W)< int> < char-array> 
Eo(R)(R)<xy> <xy> <int+ > 
Ec(R)(S)< xy> <xy> 
Ec(R)(U)<int> <int> <int> 


Ec(R)(V)<xy> <xy> 


Eo(R)(W)< xy> <xy> 
Eo(R)(X)<int> <xy><xy><xy> 


Ec(S)(A)< int> <int-array> <int-array> 


Ec(S)(C) 


Ec(S)(D)<int> <int> 
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Command 


Report-Port-Status 


Set-Port-Baud-Rate 


Set-View-Attributes 


Set-Background-Gray-Level 


Select-View 


Set-Surface-Definitions 


Set-Border- Visibility 


Set-Fixup-Level 


Set-Surface-Gray-Levels 


Set-Pixel-Beam-Position 


Set-Surface-Visibility 


Lock-Viewing-Keys 


Delete-View 


Runlength-Write 


Set-Surface-Priorities 


Raster-Write 


Rectangle-Fill 


Set-Pixel-Viewport 


Begin-Pixel-Operations 


Set-Viewport 


Set-Window 


Pixel-Copy 


Set-Segment 


End-Segment 


Seg-Segment-Detectability 


Setup Command 


PORTSTATUS 
PBAUD 

None 

None 


None 


None 
None 
FIXUP 
None 


None 


None 
None 
None 
None 


None 


None 
None 
None 
None 


None 


None 
None 


None 


None 


None 
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ESCAPE SEQUENCE COMMANDS 


Escape Sequence 


Eco(S)(G)< int> <int> <int> 
Ec(S)(H)<int> <int> 


Ec(S)(I)<int> <real> 
<real><real><xy> 


Ec(S)(K)< int> 


Eo(S)(L) << int-array> < int-array> <int-array> 


Ee (S)(M)< int> <int> 
Eo(S)(O) <int> 

Eo(S)(P)< xy> 

Es(S)(Q)<int> < char-array> 


Es(S)(R)< int> <int> 


Ec(S)(S)<int> <int> 
Eo(S)(T)<int> <int> 
Ec(S)(U) 

Ec(S)(V)< int> <int> 
Eo(S)(X)<int> <xy> 


Eo(S$)(Z)<int> <int> 


Command 


Set-Graphtext-Font-Grid 
Set-Segment-Highlighting 


Set-Segment-Image-Transform 


Delete-Segment 


Set-Current-Matching-Class 


Set-Segment-Writing Mode 
Begin-Segment 
Set-Pivot-Point 
Report-Segment-Status 


Rename-Segment 


Set-Segment-Display-Priority 
Begin-Graphtext-Character 


End-Graphtext-Character 


Set-Segment-Visibility 


Set-Segment-Position 


Delete-Graphtext-Character 


Setup Command 


None 
None 


None 


None 


None 


None 
None 
None 
None 


None 


None 
None 
None 
None 
None 


None 
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Appendix D 


This appendix includes a standard ASCII code chart 
and additional ASCII code charts:which define the 
specific characters used as parameters (indicated by 


unshaded areas). 


4112 OPERATOR'S 


BITS * 
B4 B3 B2 Bl 


Table D-1 


ASCII CHARTS 


The code charts are: 


D-1 


— Dp-2 


* Table Description 


ASCII Code Chart 
Characters Used in <Char> Parameters 
Characters Used in <Int> and <Int+ > 
‘Parameters 
Characters Used in < Int-Report> 

_ Parameters 
Characters Used in < <Xy> Parameters 
Characters. Used in < Xy-Report> 
Parameters 


ASCII (ISO-7-US) CODE CHART 


Mac Nee 2 Os 
UPPERCASE LOWERCASE 


4%. 


Rol re! © 


3 
ee 
= 
ce 
vf 
8 


D-1 


ASCII CODE CHARTS 


D-2 


Table 0-2 


CHARACTERS USED IN <CHAR> PARAMETERS 


FIGURES 


Lc rere 


th 


1 
: 4 
RODE 


Bad 
QD 
> 


w 
n 
N 
aD 
ies) 


5| 5 
eae 
x 
an 
m 


ew 
N 
an 
w 
aD 
© 


feo 
Lop) 
mn 


| se] si) 
petals | 
a ae 
wee 
DO) > 
2B 
~N a 
a 


NO 
w& 
eo 
On 
A 
™N 
9 


mS 


75 


UPPERCASE 


8 0 4 8 1 1 1 1 
Q 96 112 


P 
8 

a. ¢ 

R 


OR ee Ee 


O 
a 
+ 


89 


— 
™s 
N 


Ke) 
So 


91 


LOWERCASE 


97 sis 
if 
98 114 


Oo 
© 
i) 

mn 
Be 
a 


106 


~~ 
“a 


107 


63 


47 


| on some keyboards or systems 


(a 
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ASCII CODE CHARTS 


Table D-3 


CHARACTERS USED IN <INT> AND <INT+> PARAMETERS 


<Lol> Characters 


<Hil> Characters 


BE 
= 


13 


ap Be 


D-3 


(eu 
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ASCII CODE CHARTS 


CHARACTERS USED IN <INT-REPORT> PARAMETERS 


Table D-4 


<Hil-Report> Characters 


Q ® 8 @ 1 1 1 1 
SP 0 7; @ 5 LP 
32, 48] 
Log be ARS 
33| ag] 5 
Ge De shelve 
: 34] SO, 6 
Ha ciat 
oe SS) tS 3 2568, 
$14 dD. 
_ 36f 52.68] 
5 E 
a7) 53] 69 
“6 F 
a] Sd 70 
7 G 
i) le 
8 H 
Gn 


D-4 


O)B)4)1 


<Lol-Report> Characters 


Ol rieis 


e, a, 16 14 Yy ty 
ofofofof NUL] BLE SP OO Pa fod Pad 
fof SH / DCT a Tol key Sel Mal Mi 
2)9| [0] SIX | Dee | . 34) 2 50 B R Bi Fa 
eo Oy Hy Sal Sal Sed al Sn 
Goud OT arn ___ 36) Bs ua Le oS i 6 
ely ENQ. NAK * 5 El uje lu, 
[o}3]+0 ACK SYN & 6.1 Foi ve hy 

| 38). 53,70] __86} 10 11g 
: "| BEL | ETB el 39, - G 7H We ee bee 

8 X 
-," 
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ASCII CODE CHARTS 


Table 0-5 


CHARACTERS USED IN < XY> PARAMETERS 


<HiIY>,<HiX> Characters 


FIGGALS 


<LoX> Characters 


LOWERCASE 


om & & 8 FF & YF Fe 
oe ow nF DSF FSF «> NN | Ye OO 


<LoY>,< Extra> Characters 
6 ¢ q 
te [Pty te fea te LT 


7 ro wo n wn, wl Pall 


= NN m™~ et MW oO rR 


ow 
nn 
3S Aw ls 
yy a ey Sa sy a 
—_ slo | 
EIS Ft Sle 1G 
fe [To [s Te} Tete let 
es |e t=j- [es P| 
e{sjs}ste zt ie 
ep pee Lele ete 


D-5 


ce 
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ASCII CODE CHARTS 


Table D-6 


CHARACTERS USED IN < XY-REPORT> PARAMETERS 


<HiY-Report>, <Extra-Report>, <LoY-Report>, 
<HiX-Report>, and <LoX-Report> Characters 


a. 10 7) 7 1 
80 96 


1, 1, 


ee. 
ab 


bey 


— 
a 
ivy SS 
N 6 

a N 
id ™~ 
ND IND 


~ 
N 
= 
Ve] 
(= 
pon | 
‘cc 
ms 
mM Is 
A in 


78 94 110 


0 RUBOUT 
0 (DEL) 
79 117 127 


D-6 a 4112 OPERATOR'S 


| on some keyboards or systems 


Appendix E 


OPTIONAL KEYBOARDS 


The following optional keyboards are available for the optional keyboards, see the 4112 or 4114 Service 
terminal. For information on how to install these Manual. 


OPTION 4A: UNITED KINGDOM CHARACTER SET 


This option permits the terminal to change to a United key is pressed (or the appropriate code received by the 
Kingdom keyboard layout so that the United Kingdom terminal), the “£" sign is displayed on the screen. The 
characters are displayed. The only change is that the revised keyboard configuration is shown in Figure E-1 
“#" sign is replaced by the English “£” sign. When this and the revised ASCII code chart is shown in Table E-1. 


KYBD PAGE 
LOCK = FULL 
| sa co 


DIALOG SETUP TOGAL HARD 
AREA Cl 


Figure E-1. United Kingdom Keyboard. 
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OPTIONAL KEYBOARDS 


Table E-1 
UNITED KINGDOM CHARACTER SET 


4 “GRAPHIC Rn | LOW x | LOWY 
oe rf 

OH DG1 
see 
alee en | Dea 
RCO 
fle PENO, WAK | 
JHC Eos a 
fee ee Ee 
we 


Lf 
Q 
a 
oh, 


httaat 
a | 
th. 
© 
ic C 
Fae 
a 
bee a 
> 
Ss 
eli 
hand 
ea 


oe) 
Sad 
© 
2 
sl, 
tad 
ie) 


GS 
& 


tA 
oy 


es 8 
Sam | - 
= 2 
ome ort @~ 
= ~ 


83 99 


[ale 
Sa) 
9S 


84 


e 


85 107 ii 


FE 
G3) “nj f 
x 3 8 
=< 

Ss 8 

ga rn 

ey J 

8 LR 

=i < 

~ mal, 

oS 20 


ee 
- 
= 
nd 
ae 
>< 
S 
—- 
x 
x 
iS 
i) 


56 


‘| 

~“ 

) 

~< 

3 
= 
~ LI 

nl 

el 

wt 


es 
= 
ee 
Ss 
EE. 
“7 
wa 
FEE 
ke 
N 
a 
S 
3 
nS 


oll eee 
SS 
es! 
oe Mae 
sanesse 
mm 
” 
eee 
So (8 |S 
~~ 

my 

ke 

= 

S 

lo | 

rs 

N 


i) 


Ee 
ee 
Piel 90, 8 


60 108 


Jie 
>| Z 
ois 
=| 3' a 
|= 
ed, ~ * 
so 


110 126 


RUBOUT 
ra Od al 2) 
63 117 127 


3673-51 
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g 
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OPTIONAL KEYBOARDS 


OPTION 4C: SWEDISH CHARACTER SET 


This option changes the standard keyboard configura- pressed (or the appropriate codes are received by the 
tion to a Swedish layout and allows Swedish charac- terminal), the corresponding characters are displayed 
ters to be displayed. There are 17 changes to the on the screen. The revised keyboard configuration is 
keyboard, with three of these changes being new shown in Figure E-2 and the revised ASCII code chart 
alphabet characters. When these seventeen keys are is shown in Table E-2. 


CLEAR CANCEL 


KY8D PAGE ] 3 
LOCK = FULL 
So Ca [a] cS 


DIALOG SETUP LOCAL HARD 
AREA COPY 


Figure E-2. Swedish Keyboard. 
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OPTIONAL KEYBOARDS 


Table E-2 
SWEDISH CHARACTER SET 


HIGH X& ¥ 
} _ GRAPHIC INPUT 


aa iF 
Sh CoORPERESES 
To SR, 
LA 
ge te ie 
CUT are? 


31 47,63 


3673-52 
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OPTIONAL KEYBOARDS 


OPTION 4E: ASCII/APL CHARACTER SET 


This option enables selection of either ASCII or APL That is, the same as a standard keyboard. To obtain the 
characters to be entered and displayed. There are 47 APL (A Programming Language) character set, the ESC 
different keys in this character set, with some of the and CTRL N keys must be pressed. Once this is done, 
symbols printed on the front of the keys as well as the the terminal operates in APL mode. The APL codes are 
tops of the keys (see Figure E-3). Tables E-3 and E-4 generated when a key is pressed and APL characters 
show the ASCII and APL coding. are displayed on the screen as a result of pressing 


keys or receiving data from the host computer. 

When the terminal is turned on (and during normal 

operation), the keyboard will operate in ASCII mode. To exit APL mode (back to ASCII), the ESC and CTRL O 
keys must be pressed. 


Figure E-3, APL Keyboard Option. 
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E-6 


oh |S0m ont 


Table E-3 
ASCII CODE CHART 


HIGH X & 
GRAPHIC INPUT 


K- 
CE 8} 


(@, NOV 1981 
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Table E-4 


APL CODE CHART 


HIGH X & ¥ 


GRAPHIC INPUT 


14 46 62 
ve 


@,NOV 1981 


ate: 
64 80 


65 


a) 


90 
<< 
91 


OPTIONAL KEYBOARDS 


E U 
101 117 
A AY 
102 118 
G W 
103 119 
Bl ak 
104 120 
I 4 
105 121 
J |Z 
106 122 


107 12. 


ties 
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OPTIONAL KEYBOARDS 


OPTION 4F: DANISH/NORWEGIAN KEYBOARD 


This option changes to a Danish/Norwegian standard pressed (or the appropiate codes are received by the 
keyboard layout so that the Danish/Norwegian charac- terminal), the corresponding characters are displayed 
ters are displayed. There are 17 changes to the on the screen. The revised keyboard configuration is 

keyboard, with three of the changes being new shown in Figure E-4 and the revised ASCII code chart 
alphabetic characters. When these 17 keys are is shown in Table E-5. 


KYBD PAGE 
LOCK FULL = XMT 
DIALOG SETUP LOCAL HARD 
AREA copy 


ea 


Figure E-4. Danish/Norwegian Keyboard. 
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Table E-5 
DANISH/NORWEGIAN CHARACTER SET 


{COCOA 
ile | soon, 

1K | DC2 
igtets 
els] 
ENO Ra 
phe as 


o 
© 
& 


mi 


aE 8, 


ettitn, 


> 


a 


RUBOUT 
(DEL) 
127 


3673-55 
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